Snacfg PrintSessionAPPC

NoteConfiguration settings specified with snacfg printsessionAPPC correspond to local print server setting configured with SNA Server Manager. Syntax snacfg [#configpath] printsessionAPPCname /list
snacfg [#configpath] printsessionAPPCname /print
snacfg [#configpath] printsessionAPPC printsessionAPPCname /add /server:servername /localLUalias:localLUname[options]
snacfg [#configpath] printsessionAPPC printsessionAPPCname [options]
snacfg [#configpath] printsessionAPPC printsessionAPPCname /delete

where
 

#configpath

Specifies the path of the configuration file to view or change. If the configuration path is omitted, SNA Server will attempt to access the configuration file on the local system, using the path \SNAServerRoot\SYSTEM\CONFIG\COM.CFG, where SNAServerRoot is the SNA Server root directory.

/list

Generates a list of APPC print sessions.

/print

Displays a list of the configuration settings of a print session. The displayed command does not contain the word snacfg so that it can be redirected to a command file. Command files are discussed earlier in this chapter.

/add

Adds a print session to the Host Print Service. To configure the print session, you must specify the server name and the configured APPC local LU alias name after the /add. The required options are /server:servername and /localLUalias:localLUname

/delete

Deletes the printer session. To delete the print session, you must specify the server name and the configured local LU alias after the /delete.

Options

Are as shown in the following list.

/autoactivate: { yes | no }

Specifies whether the printer session will automatically activate when SNA Server is started. The default is yes.

/bestfit: { yes | no }

Specifies whether to scale the output to the paper size. The default is yes.

/codepage: {Country | Custom}

This defines the host code page language in which the print jobs are printed. The default is Country and the default language is English (United States) [037]. To change the default language, provide the number of the host code page of the country you want using the /country option. See Table A.2 for valid values.

If you want to use a custom file for the host code page, you must use /customfile:text, where the text value is the name of the file containing the specifications.

/collate: { yes | no }

Adds an option to collate pages sequentially.

/color: { yes | no }

For color printers, printing will be gray scale if no is selected.

/comment:"text"

Adds an optional comment for the printer session. It can contain as many as 25 characters; enclose the comment in quotes.

/country:value

Specifies the language in which the print jobs are printed. To specify the language value, use the Host Code Page Number in the left column of Table A.2.

/customfile:"text"

Specifies the name of the file containing the custom language translation information. Use this option if you specify /codepage:custom.

/devicename:"text"

Specifies the name of the destination printer.

/duplex:simplex | horizontal | vertical

Specifies printing on two-sided paper.

/filterfile:"text"

This parameter is a defined programming API that allows you to pass the printer data stream to a third-party or user-supplied DLL. Enter the text of the file to which the printer data stream should go.

/font:"text"

Specifies the font to be used in the printer sessions. This can be any available font installed on the computer.

/formname:string

Specifies the name for the form.

/margin:left, right, top, bottom

Specifies the margins of the page, in inches, in the order of left, right, top, bottom. The default margins are 0".

/orientation:portrait, landscape

Specifies the page layout as portrait or landscape.

/pagewidth:value (0-255)

Specifies the width of page in characters.

/papersize:value

Specifies the size of the paper for printing. See Table A.3 for a list of valid values.

/paperlength:value

Specifies the length of the paper for printing. The values for paperlength and paperwidth are in tenths of a millimeter, and override the papersize setting.

/paperwidth:value

Specifies the width of the paper. The values for paperlength and paperwidth are in tenths of a millimeter, and override the papersize setting.

/pdtfile:"text"

Specifies the name of a printer definition file. For more information about printer definition files, see Chapter 6 of this manual.

/provider:"text"

This parameter maps to one of the two print provider DLLs (PPD3270.DLL or PPD5250.DLL) and tells Host Printer Service which DLL to load for the printer communications (ppd3270.dll or ppd5250.dll). The text for snacfg printsessionappc is PPD5250.

/printtofile:"text"

Specifies the name of a text file to which the output is to be sent. When information is entered into this parameter, the print job is saved into a file on the hard drive instead of sending it to the printer.

/quality:high, medium, low, draft

Specifies the quality of print.

/scalefactor:value

specifies the amount by which the printed output is to be scaled from the physical page size, divided by 100. For example, a scale factor of 50 would make the printed output half its normal size, 10 would be one tenth, etc.

/server:"text"

Specifies the name of the server to which the session should attach. This is usually the name of an SNA Server computer that is running the Host Print Service in the subdomain. When /add is used, this option is required.

/systemtype: {AS400 | System36}

Specifies the type of system being used.

/truetype:bitmap, download, substitute

Specifies TrueType fonts or substitutes.

/uniqueextension: { yes | no }

When the /printtofile option is used, the Host Print Service can generate a unique output file extension for each print job.

/as400devicename:"text"

Specifies the name of the AS/400 computer that will be sending the print job.

/locallualias:"text"

Specifies the previously configured local LU alias. This is a required parameter when using /add.

/remotelualias:"text"

Specifies the default remote APPC LU. If an LU is specified here, do not enter text into /remotefqname.

/remotefqname:"text"

Specifies the fully qualified name or alias of a remote APPC LU. The fully qualified name is the network name and LU name. If text is entered here, do not enter text into /remotelualias.

/modename:"text"

The default mode name is QPCSUPP. The other mode names available are: #INTERSC, BLANK, and QSERVER.

/username:"text"

Specifies the authorized user.

/password:"text"

Specifies the user password.

/Hostprinttransform: yes, no

Enter yes to activate the Host Print Transform feature.

/msgqname:"text"

Specifies the qualified name of the message queue to which operational messages for this device are sent.

/msglibname:"text"

Specifies the library in which the message queue is located.

/hostprintertype:"text"

Specifies the type of host printer.