Naming Convention for Printer Support Variables

All printer variables begin with the standard prefix, QAP. Variables that contain print parameters for keywords for JCL statements and the TSO/E ALLOCATE and PRINTDS commands are further identified as follows. In those variables, the fourth letter indicates the command or statement to which the parameter belongs.
Fourth letter
Command or statement
 
 
T
TSO/E ALLOCATE command
P
TSO/E PRINTDS command
O
OUTPUT JCL statement
D
JCL DD statement.

The remaining letters are the first letters of the parameter itself. For example, in QAPTSYSO, QAP is the standard prefix, T indicates the TSO/E ALLOCATE command, and SYSO indicates the SYSOUT parameter.

Table 1. Printer definition variables - table
Variable name Panel name and field name or derivation Format/description of variable contents
QAPTSO Derived from all the variables in this table that contain TSO/E ALLOCATE values. Can be used in the invocation of a print command or program on panel ICQAPE80 to reference all the TSO/E ALLOCATE parameters that are stored in this table.

Do not use QAPTSO when calling a CLIST; parsing errors can result if any of the table variables contain TSO/E ALLOCATE parameters with multiple values, such as QAPTCOPI with the syntax COPIES(b1(g1,g2,…)), or QAPTCHAR with the syntax CHARS(f1 f2 …).
QAPDSN Obtained from the application that invoked the printer selection CLIST, ICQCPC00. Contains the fully-qualified name of the data set to be printed.
QAPDDN Obtained from the application that invoked the printer selection CLIST, ICQCPC00. Contains the name of the file to be printed.
QAPLOC ICQAPE30 - LOCATION field Required.

Can contain any characters, including embedded blanks, except for an asterisk, single quote, or parenthesis.

Displayed to the user on the printer selection panel, ICQCPE00.

Can be used as a subsetting display argument in invocation of ICQCPC00.

Must form unique combination with QAPFORM.
QAPFORM ICQAPE30 - PRINT FORMAT field Required.

Can contain A-Z, 0-9, @, #, and $, with the first character not numeric.

Displayed to the user on the printer selection panel ICQCPE00.

Can be used as a subsetting display argument in invocation of ICQCPC00.

Must form unique combination with QAPLOC.
QAPTYPE ICQAPE30 - PRINTER TYPE field Can contain A-Z, 0-9, and a dash (-).

Embedded blanks are valid.

Can be used as a subsetting display argument in invocation of ICQCPC00.
QAPDESC ICQAPE30 - DESCRIPTION field Can contain any combination of characters, including embedded blanks.

Displayed to the user on the printer selection panel ICQCPE00.
QAPONLIN ICQAPE30 - ONLINE field Required.

Can contain Y or N.

Used as a display criteria by printer selection CLIST. Printers that contain an N in this field are not displayed to users unless the CLIST was called with OFFLINE specified.
QAPDSTND ICQAPE30 - SYSTEM NAME field Can contain A-Z, 0-9, @, #, and $.

If QAPDSTID (PRINTER NAME) is specified, this value becomes c1 in the variables QAPDDEST, QAPODEST, and QAPTDEST. Without QAPDSTID, this value cannot be assigned.
QAPDSTID ICQAPE30 - PRINTER NAME field Required if SYSTEM NAME specified.

If SYSTEM NAME is specified, this variable can contain A-Z, 0-9.

If SYSTEM NAME is null, this variable can contain A-Z, 0-9, @, #, and $.

This value always becomes c1 in the variable QAPTDEST.

If there is no value in QAPDSTND, this value becomes c1 in the variables QAPDDEST, QAPODEST, and QAPTDEST.

If there is a value in QAPDSTND, this value becomes c2 in the variables QAPDDEST, QAPODEST, and QAPTDEST.
QAPTDEST Derived from QAPDSTID DEST parameter on TSO/E ALLOCATE command.
Format:
DEST(c2)
QAPDDEST Derived from QAPDSTND and QAPDSTID DEST parameter on JCL DD statement.
Format:
DEST=(c1,c2)
QAPODEST Derived from QAPDSTND and QAPDSTID DEST parameter on JCL OUTPUT command.
Format:
DEST=(c1.c2)
QAPOUTDE ICQAPE50 and ICQAPE53 - OUTPUT DESCRIPTOR field Can contain A-Z, 0-9, @, #, or $, with the first character non-numeric.

Becomes c1 in the variable QAPTOUTD.
QAPTOUTD Derived from QAPOUTDE OUTDES parameter on TSO/E ALLOCATE command.
Format:
OUTDES (c1)
QAPOUTC ICQAPE50 and ICQAPE54 - SYSOUT CLASS field Can contain A-Z, 0-9, or *.

Becomes c1 in the variables QAPTSYSO, QAPDSYSO, and QAPOCLAS.
QAPOUTP ICQAPE50 - SYSOUT PROGRAM field Can contain A-Z, 0-9, @, #, and $, with the first character not numeric.

Becomes c2 in the variables QAPDSYSO, QAPOWRIT, and QAPTWRIT.
QAPOUTF ICQAPE50 and ICQAPE53 - SYSOUT FORM field Can contain A-Z, 0-9, @, #, and $.

Becomes c3 in the variable QAPDSYSO. Becomes c1 in the variable QAPTFORM.
QAPTSYSO Derived from QAPOUTC SYSOUT parameter on TSO/E ALLOCATE command.
Format:
SYSOUT(c1)
QAPDSYSO Derived from QAPOUTC, QAPOUTP, and QAPOUTF SYSOUT parameter on the JCL DD statement.
Format:
SYSOUT(c1,c2,c3)
QAPTOUTF Derived from QAPOUTF FORMS parameter on TSO/E ALLOCATE command.
Format:
FORMS(c1)
QAPOCLAS Derived from QAPOUTC CLASS parameter on JCL OUTPUT command.
Format:
CLASS=c1
QAPOWRIT Derived from QAPOUTP WRITER parameter on JCL OUTPUT command.
Format:
WRITER=c2
QAPTWRIT Derived from QAPOUTP WRITER parameter on TSO/E ALLOCATE command.
Format:
WRITERc2
QAPFORMS ICQAPE50 - OUTPUT FORMS field Can contain A-Z, 0-9.

Becomes c1 in the variables QAPOFRMS and QAPTFORM.
QAPOFRMS Derived from QAPFORMS FORMS parameter on JCL OUTPUT command.
Format:
FORMS=c1
QAPCTRL ICQAPE50 - DATA CONTROL field Can contain A or M for ANSI or Machine.

Indicates to the print function whether the data contains carriage control characters.
QAPUCS ICQAPE50 - UCS NAME field Can contain A-Z, 0-9.

Becomes c1 in the variables QAPDUCS and QAPOUCS.
QAPDUCS Derived from QAPUCS UCS parameter on JCL DD statement.
Format:
UCS=c1
QAPOUCS Derived from QAPUCS UCS parameter on JCL OUTPUT command.
Format:
UCS=c1
QAPTUCS Derived from QAPUCS UCS parameter on TSO/E ALLOCATE command.
Format:
UCS(c1)
QAPFCB ICQAPE50 - FCB NAME field Can contain A-Z, 0-9, @, #, and $.

Becomes c1 in the variables QAPDFCB and QAPOFCB.
QAPDFCB Derived from QAPFCB FCB parameter on JCL DD statement.
Format:
FCB=c1
QAPOFCB Derived from QAPFCB FCB parameter on JCL OUTPUT command.
Format:
FCB=c1
QAPHOLD ICQAPE50 and ICQAPE53 - HOLD field Can contain Y or N.

Used to generate the variables QAPTHOLD and QAPDHOLD.
QAPTHOLD Derived from QAPHOLD HOLD or NOHOLD parameter on TSO/E ALLOCATE command.
Format:
HOLD (QAPHOLD = Y) or
 
NOHOLD (QAPHOLD = N)
QAPDHOLD Derived from QAPHOLD HOLD parameter on JCL DD statement.
Format:
HOLD=Y (QAPHOLD = Y) or
 
HOLD=N (QAPHOLD = N)
QAPLINEC ICQAPE50 - LINE COUNT field Can contain 0 to 255.

Becomes n1 in the variable QAPOLINE.
QAPOLINE Derived from QAPLINEC LINECT parameter on JCL OUTPUT command.
Format:
LINECT=nt
QAPMODN ICQAPE51 - MODULE NAME field Required if TRANSLATE CODE is specified in print definition.

May contain A-Z, 0-9, @, #, and $.

Becomes c1 in the variables QAPTMODI, QAPDMODI, and QAPOMODI.
QAPMODX ICQAPE51 - TRANSLATE CODE field Can contain 0, 1, 2, or 3.

Becomes n1 in the variables QAPTMODI, QAPDMODI, and QAPOMODI.
QAPTMODI Derived from QAPTMODN and QAPTMODX. MODIFY parameter on TSO/E ALLOCATE command.
Format:
MODIFY(c1,n1)
QAPDMODI Derived from QAPTMODN and QAPTMODX. MODIFY parameter on JCL DD statement.
Format:
MODIFY=(c1,n1)
QAPOMODI Derived from QAPTMODN and QAPTMODX. MODIFY parameter on JCL OUTPUT command.
Format:
MODIFY=(c1,n1)
QAPOPTCD ICQAPE51 - OPTCD J field Can contain Y or N.

Used to generate the variables QAPTOPTC, QAPDOPTC, and QAPOTRC.
QAPTOPTC Derived from QAPOPTCD OPTCD parameter on TSO/E ALLOCATE command.
Format:
OPTCD(J)
QAPDOPTC Derived from QAPOPTCD OPTCD parameter on JCL DD command.
Format:
OPTCD=(J)
QAPOTRC Derived from QAPOPTCD TRC parameter on JCL OUTPUT command.
Format:
TRC=Y
QAPFLN ICQAPE51 - FLASH NAME field Can contain A-Z, 0-9, @, #, and $.

Becomes c1 in the variables QAPTFLAS, QAPDFLAS, and QAPOFLAS.
QAPFLC ICQAPE51 - FLASH COUNT field Can contain 1 to 255.

Becomes n1 in the variables QAPTFLAS, QAPDFLAS, and QAPOFLAS.
QAPTFLAS Derived from QAPFLN and QAPFLC FLASH parameter on TSO/E ALLOCATE command.
Format:
FLASH(c1,n1)
QAPDFLAS Derived from QAPFLN and QAPFLC FLASH parameter on JCL DD statement.
Format:
FLASH=(c1,n1)
QAPOFLAS Derived from QAPFLN and QAPFLC FLASH parameter on JCL OUTPUT command.
Format:
FLASH=(c1,n1)
QAPBURST ICQAPE51 - BURST field Can contain Y or N.

Used to generate the entries: QAPTBURS, QAPDBURS, and QAPOBURS.
QAPTBURS Derived from QAPBURST BURST or NOBURST parameter on TSO/E ALLOCATE command.
Format:
BURST (QAPBURST = Y) or
 
NOBURST (QAPBURST = N)
QAPDBURS Derived from QAPBURST BURST parameter on JCL DD statement.
Format:
BURST=Y (QAPBURST = Y) or
 
BURST=N (QAPBURST = N)
QAPOBURS Derived from QAPBURST BURST parameter on JCL OUTPUT command.
Format:
BURST=Y (QAPBURST = Y) or
 
BURST=N (QAPBURST = N)
QAPCPYB ICQAPE52 - TOTAL field (Number of copies) Required if PER GROUP field has an entry.

May contain 1 - 255.

Becomes b1 in the variables QAPTCOPI, QAPDCOPI, and QAPOCOPI.
QAPCPYG1 through QAPCPYG8 ICQAPE52 - PER GROUP field (8 subfields) Subfields must be filled in from left to right.

Each subfield can contain numbers 1-255.

Becomes g1-g8 in the variables QAPTCOPI, QAPDCOPI, and QAPOCOPI.
QAPTCOPI Derived from QAPTCPYB and QAPCPYG1 through QAPCPYG8 COPIES parameter on TSO/E ALLOCATE command.
Format:
COPIES (b1,(g1,g2,…,g8))
QAPDCOPI Derived from QAPTCPYB and QAPCPYG1 through QAPCPYG8 COPIES parameter on JCL DD statement.
Format:
COPIES=(b1,(g1,g2,…,g8))
QAPOCOPI Derived from QAPTCPYB and QAPCPYG1 through QAPCPYG8 COPIES parameter on JCL OUTPUT command.
Format:
COPIES=(b1,(g1,g2,…,g8))
QAPGROUP ICQAPE52 - GROUPID NAME field Can contain A-Z, 0-9.

Becomes c1 in the variable QAPOGROU.
QAPOGROU Derived from QAPGROUP GROUPID parameter on JCL OUTPUT command.
Format:
GROUPID=c1
QAPFORMD ICQAPE52 - FORMDEF NAME field Can contain A-Z, 0-9, @, #, and $.

Becomes c1 in the variable QAPOFORM.
QAPOFORM Derived from QAPFORMD FORMDEF parameter on JCL OUTPUT command.
Format:
FORMDEF=c1
QAPPAGED ICQAPE52 - PAGEDEF NAME field Can contain A-Z, 0-9, @, #, and $.

Becomes c1 in the variable QAPOPAGE.
QAPOPAGE Derived from QAPPAGED PAGEDEF parameter on JCL OUTPUT command.
Format:
PAGEDEF=c1
QAPINDEX ICQAPE52 - INDEX field Can contain 1 - 31.

Becomes n1 in the variable QAPOINDE.
QAPOINDE Derived from QAPINDEX INDEX parameter on JCL OUTPUT command.
Format:
INDEX=n1
QAPLINDE ICQAPE52 - LEFT INDEX field Can contain 1 - 31.

Becomes n1 in the variable QAPOLIND.
QAPOLIND Derived from QAPLINDE LINDEX parameter on JCL OUTPUT command.
Format:
LINDEX=n1
QAPINDCF ICQAPE53 - DCF field Can contain Y or N.

Used to generate QAPPDCF.
QAPPDCF Derived from QAPINDCF DCF or NODCF parameter on TSO/E PRINTDS command.
Format:
DCF (QAPINDCF = Y) or
 
NODCF (QAPINDCF = N)
QAPINMEM ICQAPE53 - MEMBERS field Can contain Y or N. Used to generate QAPPMEMB.

Used to generate QAPPMEMB.
QAPINDIR ICQAPE53 - DIRECTORY field Can contain Y or N.

Used to generate QAPPMEMB.
QAPPMEMB Derived from QAPINMEM and QAPINDIR MEMBERS, DIRECTORY or ALL parameter on TSO/E PRINTDS command.
Format:
MEMBERS (QAPINMEM = Y, QAPINDIR = N), or
 
DIRECTORY (QAPINMEM = N, QAPINDIR = Y), or
 
ALL (QAPINMEM = Y, QAPINDIR = Y)
QAPINTOD ICQAPE53 - TO DATASET field Can contain a fully- or partially-qualified data set name. Becomes t1 in the variable QAPPTODS.
QAPPTODS Derived from QAPINTOD TODATASET parameter on TSO/E PRINTDS command.
Format:
TODATASET(t1)
QAPINPLN ICQAPE54 - PAGE LENGTH field Can contain 6 - 4095. Becomes n1 in the variable QAPPPLEN.
QAPPPLEN Derived from QAPINPLN. PAGELEN parameter on TSO/E PRINTDS command.
Format:
PAGELEN(n1)
QAPINTIT ICQAPE54 - TITLE field Can contain Y or N. Used to generate QAPPTITL.

Used to generate QAPPTITL.
QAPPTITL Derived from QAPINTIT TITLE or NOTITLE parameter on TSO/E PRINTDS command.
Format:
TITLE (QAPINTIT =Y) or
 
NOTITLE (QAPINTIT = N)
QAPINTMR ICQAPE54 - TOP MARGIN field Can contain numbers 0 through 6 less than the value of PAGELEN. Becomes n1 in the variable QAPPTMAR.
QAPPTMAR Derived from QAPINTMR TMARGIN parameter on TSO/E PRINTDS command.
Format:
TMARGIN(N1)
QAPINBMR ICQAPE54 - BOTTOM MARGIN field Can contain numbers 0 through 6 less than the value of PAGELEN. Becomes n1 in the variable QAPPBMAR.
QAPPBMAR Derived from QAPINBMR BMARGIM parameter on TSO/E PRINTDS command.
Format:
BMARGIN(N1)
QAPINLMR ICQAPE54 - LEFT MARGIN field Can contain 0 - 255. Becomes n1 in the variable QAPPLMAR.
QAPPLMAR Derived from QAPINLMR LMARGIN parameter on TSO/E PRINTDS command.
Format:
LMARGIN(N1)
QAPINMAX ICQAPE54 - MAXIMUM LENGTH field A number. Becomes n1 in the variable QAPPFOLD.
QAPINFOL ICQAPE54 - EXCESS LENGTH field Can contain FOLD or TRUN. Used to generate the variable QAPPFOLD.
QAPPFOLD Derived from QAPINMAX and QAPINFOL FOLD or TRUNCATE parameter on TSO/E PRINTDS command.
Format:
FOLD (n1) (QAOUNFIK = FOLD)
 
TRUNCATE(n1) (QAPINFOL = TRUN)
QAPINSPA ICQAPE54 - LINE SPACING field Can contain 1, 2, 3 or C.

Used to generate QAPPSPAC.
QAPPSPAC Derived from QAPINSPA CCHAR, SINGLE, DOUBLE or TRIPLE parameter on TSO/E PRINTDS command.
Format:
CCHAR (QAPINSPA = C)
 
SINGLE (QAPINSPA = 1)
 
DOUBLE (QAPINSPA = 2)
 
TRIPLE (QAPINSPA = 3)
QAPINLFR ICQAPE55 - LINES - FROM field (ignore embedded line numbers) A number. Becomes n1 in the variable QAPPLINE.
QAPINLTO ICQAPE55 - LINES - TO field (ignore embedded line numbers) A number. Becomes n2 in the variable QAPPLINE.
QAPINEFR ICQAPE55 - LINES - FROM field (use embedded line numbers) A number. Becomes n1 in the variable QAPPLINE.
QAPINETO ICQAPE55 - LINES - TO field (use embedded line numbers) A number. Becomes n2 in the variable QAPPLINE.
QAPPLINE Derived from QAPINLFR and QAPINLTO, or from QAPINEFR and QAPINETO. LINES parameter on TSO/E PRINTDS command.
Format:
LINES(n1:n2)
QAPINNUM ICQAPE55 - LOC field A number. Becomes n1 in the variable QAPPNUMS.
QAPINNLE ICQAPE55 - LENGTH field A number less than 8. Becomes n2 in the variable QAPPNUMS.
QAPPNUMS Derived from QAPINLFR/QAPINLTO or QAPINEFR/QAPINETO, QAPINNUM, and QAPINNLE NUM, SNUM or NONUM parameter on TSO/E PRINTDS command.
Format:
NUM(n1,n2) (QAPINLFR/QAPINLTO set)
 
NONUM (QAPINEFR/QAPINETO set)
QAPINFC1 - QAPINFCA ICQAPE56 - FROM COLUMN 1 through FROM COLUMN 10 fields A number. Becomes s1 through s10 in the variable QAPPCOLS.
QAPINTC1 - QAPINTCA ICQAPE56 - TO COLUMN 1 through TO COLUMN 10 fields A number. Becomes e1 through e10 in the variable QAPPCOLS.
QAPPCOLS Derived from QAPINFC1 - QAPINFCA and QAPINTC1 - QAPINTCA COLUMNS parameter on TSO/E PRINTDS command.
Format:
COLUMNS(s1:e1, s2:e2,… s10:e10)
QAPPTRC ICQAPE57 - TRC field Can contain Y or N. Y indicates OPTCD(J).
QAPATT1 - QAPATT6 ICQAPE60 - ATTRIBUTE 1 through ATTRIBUTE 6 fields Can contain any character combination including embedded blanks.

Not used to generate any MVS™ system parameters. Can be used to store information required for a local print function or for locally supported system keywords.
QAPATT7 - QAPATT20 Not displayed on any panel These variables are available but do not appear on any TSO/E panel. A copy of panel ICQAPE60 may be used to externalize more of these variables if your installation needs them.
QAPNFONT ICQAPE70 - NUMBER OF FONTS field Can contain numbers 1 - 99.

Denotes the maximum number of fonts that the user can select. A blank defaults to the maximum of 99.
QAPFONL ICQAPE70 - PERMIT SELECTION field Can contain Y or N.

Y indicates that the user should be presented with the font selection panel, ICQCPE10, if CHARSEL was also specified on the call to the printer selection CLIST, ICQCPC00.
QAPCHARD Derived from the QAPFDEV field of the fonts that were selected by the administrator on panel ICQAPE70. Contains the internal names of the fonts that were selected by the administrator. It contains as many fonts as were selected.
Format:
font1 font2 fontn

Four of these fonts become f1 - f4 in the variables QAPTCHAR, QAPDCHAR, and QAPOCHAR.
QAPCHARS Derived from the QAPFSCR field of the fonts that were selected by the administrator on panel ICQAPE70. Contains the script names of the fonts selected by the administrator. It contains as many fonts as were selected.
Format:
font1 font2 fontn
QAPTCHAR Derived from QAPCHARD. A maximum of 4 fonts are extracted from QAPCHARD to create the character string in this variable. CHARS parameter on TSO/E ALLOCATE command.
Format:
CHARS(f1 f2 f3 f4)
QAPDCHAR Derived from QAPCHARD. A maximum of 4 fonts are extracted from QAPCHARD to create the character string in this variable. CHARS keyword on JCL DD card.
Format:
CHARS=(f1,f2,f3,f4)
QAPOCHAR Derived from QAPCHARD. A maximum of 4 fonts will be extracted from QAPCHARD to create the character string in this variable. CHARS keyword on JCL DD statement.
Format:
CHARS=(f1,f2,f3,f4)
QAPINFUN ICQAPE80 - PRINTDS USED field Can contain Y or N. Y indicates PRINTDS is used. N indicates PRINTDS is not used.
function names ICQAPE80 - print function names Only one of the following three print function name fields can be specified.
QAPCLIST ICQAPE80 - CLIST NAME field Can contain A-Z, 0-9, @, #, and $, with the first character non-numeric.

Contains the name of the CLIST that you want to print the data associated with this printer. If you specify PRINT on the call to the printer selection CLIST, the named CLIST is automatically invoked when the user selects the printer.
QAPCOMM ICQAPE80 - COMMAND NAME field May contain A-Z, 0-9, @, #, and $, with the first character non-numeric.

Contains the name of the command that you want to print the data associated with this printer. If you specify PRINT on the call to the printer selection CLIST, the named command is automatically invoked when the user selects the printer.
QAPPGM ICQAPE80 - PROGRAM NAME field May contain A-Z, 0-9, @, #, and $, with the first character non-numeric.

Contains the name of the program that you want to print the data associated with this printer. If you specify PRINT on the call to the printer selection CLIST, the named program is automatically invoked when the user selects the printer.
QAPPARM ICQAPE80 - PARAMETERS field May contain any combination of characters including embedded blanks.

Contains the parameter string that you want passed to the print function when a user selects this printer. The print function scans this field once. You may want to pass variables from this table, such as &QAPSYSO or, if the print function is a program or command, &QAPTSO. (Do not use &QAPTSO with a CLIST). The variables &QAPATT1 through &QAPATT20 can also be passed. The characters &,; /, *, -, or + in these variables will be treated as data.
QAPFTABL Generated dynamically If a font table is associated with this printer, this variable contains its name. The name syntax is ICQSPnnn, where nnn is a number from 0 to 999.
QAPITEM Always contains "1" Used internally for table searching.
QAPID Unique identifier Used for control purposes. Assigned to the table row when it is created and remains unchanged when other contents are modified by the administrator.
Parent topic: Variables