# CHARS parameter - IBM-JCL

Keyword, optional

Purpose

Use the CHARS parameter to specify the name of one or more coded fonts for printing this sysout data set on an AFP printer.

Note:

• CHARS applies only for a data set that is either printed on an AFP printer or processed by Infoprint Server.
• STD applies only on a JES3 system.

1.Syntax

• You can omit the parentheses if you code only one font-name.
• Null positions in the CHARS parameter are invalid. For example, you cannot code
• CHARS=(,font-name) or CHARS=(font-name,,font-name).

2.Subparameter Definition

font-name
Names a coded font or character-arrangement table. Each font-name is 1 through 4 alphanumeric or national ($, #, @) characters. Code one to four names. STD Specifies the standard character-arrangement table. JES3 uses the standard table specified at initialization. Note: STD is supported only on JES3 systems. DUMP Requests a high-density dump of 204-character print lines from a 3800. If more than one font-name is coded, DUMP must be first. Note: DUMP is valid only on the OUTPUT JCL statement referenced in a SYSABEND or SYSUDUMP DD statement that specifies a sysout data set for the dump. 3.Defaults If you do not code the OUTPUT JCL CHARS parameter, JES uses the following, in order: 1. The DD CHARS parameter. 2. The DD UCS parameter value, if coded. 3. The OUTPUT JCL UCS parameter value, if coded. If no character-arrangement table is specified on the DD or OUTPUT JCL statements, JES uses an installation default specified at initialization. 4.Overrides A CHARS parameter on the sysout DD statement overrides the OUTPUT JCL CHARS parameter. For a data set scheduled to the Print Services Facility (PSF), PSF uses the following parameters, in override order, to select the font list: 1. Font list in the library member specified by an OUTPUT JCL PAGEDEF parameter. 2. DD CHARS parameter. 3. OUTPUT JCL CHARS parameter. 4. DD UCS parameter. 5. OUTPUT JCL UCS parameter. 6. JES installation default for the device. 7. Font list on the PAGEDEF parameter in the PSF-cataloged procedure. 5.Requesting a High-Density Dump You can request a high-density dump on the 3800 through two parameters on the DD statement for the dump data set or on an OUTPUT JCL statement referenced by the dump DD statement: • FCB=STD3. This parameter produces dump output at 8 lines per inch. • CHARS=DUMP. This parameter produces 204-character print lines. You can code one or both of these parameters. You can place both on the same statement or one on each statement. 6.Example of the CHARS Parameter //OUTDS2 OUTPUT CHARS=(GT12,GB12,GI12) In this example, the output from the AFP printer will be printed in three upper and lower case fonts: GT12, Gothic 12-pitch; GB12, Gothic Bold 12-pitch; and GI12, Gothic Italic 12-pitch. CKPTLINE parameter Parameter Type Keyword, optional Purpose Use the CKPTLINE parameter to specify the maximum number of lines in a logical page. JES uses this value, with the CKPTPAGE parameter, to determine when to take checkpoints while printing the sysout data set or transmitting the systems network architecture (SNA) data set. Note: A JES3 system supports this parameter only when PSF prints the sysout data set on an AFP printer. 1.Syntax CKPTLINE=nnnnn 2.Subparameter Definition nnnnn Specifies the maximum number of lines in a logical page. nnnnn is a number from 0 through 32,767. 3.Defaults If you do not code the CKPTLINE parameter, JES2 uses an installation default specified at initialization. JES3 provides no installation default. 4.Example of the CKPTLINE Parameter //OUTDS3 OUTPUT CKPTLINE=4000,CKPTPAGE=5 In this example, the sysout data set will be checkpointed after every 5 logical pages. Each logical page contains 4000 lines. CKPTPAGE parameter Parameter Type Keyword, optional Purpose Use the CKPTPAGE parameter to specify the number of logical pages: • To print before JES takes a checkpoint. • To transmit as a single systems network architecture (SNA) chain to an SNA work station before JES takes a checkpoint. The CKPTLINE parameter specifies the number of lines in these logical pages. Note: A JES3 system supports this parameter only when PSF prints the sysout data set on an AFP printer. 1.Syntax CKPTPAGE=nnnnn 2.Subparameter Definition nnnnn Specifies the number of logical pages to print or transmit before the next sysout data set checkpoint is taken. nnnnn is a number from 1 through 32,767. 3.Defaults If you do not code the CKPTPAGE parameter, JES2 uses an installation default specified at initialization; the default may also indicate whether checkpoints are to be based on page count or time. JES3 provides no installation default. 4.Relationship to Other Parameters If you code both the CKPTPAGE and CKPTSEC parameters: • JES2 uses the value on the CKPTSEC parameter, provided the installation did not specify at initialization that checkpoints are to be based only on page count or time. • JES3 uses the value on the CKPTPAGE parameter. 5.Example of the CKPTPAGE Parameter //OUTDS4 OUTPUT CKPTPAGE=128,CKPTLINE=58 In this example, the sysout data set will be checkpointed after every 128 logical pages. Each logical page contains 58 lines. CKPTSEC parameter Parameter Type Keyword, optional Purpose Use the CKPTSEC parameter to specify how many seconds are to elapse between checkpoints of the sysout data set that JES is printing. Note: A JES3 system supports this parameter only when PSF prints the sysout data set on an AFP printer. 1.Syntax CKPTSEC=nnnnn 2.Subparameter Definition nnnnn Specifies the number of seconds that is to elapse between checkpoints. Nnnnn is a number from 1 through 32,767. 3.Defaults If you do not code the CKPTSEC parameter, JES2 uses an installation default specified at initialization; the default may also indicate whether checkpoints are to be based on page count or time. JES3 provides no installation default. 4.Relationship to Other Parameters If you code both the CKPTPAGE and CKPTSEC parameters: • JES2 uses the value on the CKPTSEC parameter, provided the installation did not specify at initialization that checkpoints are to be based only on page count or time. • JES3 uses the value on the CKPTPAGE parameter. 5.Example of the CKPTSEC Parameter //OUTDS5 OUTPUT CKPTSEC=120 In this example, the sysout data set will be checkpointed after every 120 seconds, or 2 minutes. CLASS parameter Parameter Type Keyword, optional Purpose Use the CLASS parameter to assign the sysout data set to an output class. Note: If a sysout data set has the same class as the JOB statement MSGCLASS parameter, the job log appears on the same output listing as the sysout data set. 1.Syntax CLASS= {class} {* } 2.Subparameter Definition class Identifies the output class for the data set. The class is one character: A through Z or 0 through 9, which you may optionally include in quotation marks. The attributes of each output class are defined during JES initialization; specify the class with the desired attributes. * Requests the output class in the MSGCLASS parameter on the JOB statement. null value Requests the output class in the MSGCLASS parameter on the JOB statement. 3.overrides The class subparameter of the DD statement SYSOUT parameter overrides the OUTPUT JCL CLASS parameter. On the DD statement, you must code a null class in order to use the OUTPUT JCL CLASS parameter; for example: //OUTDS DD SYSOUT=(,),OUTPUT=*.OUT1 4.Held Classes in a JES2 System An installation option at JES2 initialization determines if both the class for the sysout data set and the class for the job’s messages must be held in order for a sysout data set to be held. A sysout data set is held in the following cases: • The sysout DD statement contains HOLD=YES. • The sysout DD statement does not contain a HOLD parameter or contains HOLD=NO but requests a class that the installation defined as held and defined as: • – Not requiring the message class to be a held class in order for the sysout data set to be held. The JOB statement MSGCLASS parameter can specify any class. – Requiring the message class to be a held class in order for the sysout data set to be held. The JOB MSGCLASS parameter must also specify a held class. • The OUTPUT JCL statement specifies OUTDISP=HOLD. A sysout data set is not held in the following cases: • The sysout DD statement does not contain a HOLD parameter or contains HOLD=NO and requests: • – A class that the installation defined as not held. – A class that the installation defined as held and defined as requiring the message class to be a held class in order for the sysout data set to be held. The JOB MSGCLASS parameter must specify a class that is not held. Contact the installation to find out if holding the sysout class depends on a held MSGCLASS class. 4.Held Classes in a JES3 System If CLASS specifies a class-name that is defined to JES3 as a held class for the output service hold queue (Q=HOLD), all of the new output characteristics might not be included in the data set on the writer queue when (1) the data set is moved from the hold queue to the output service writer queue (Q=WTR),(2) the data set includes an OUTPUT JCL statement, and (3) the NQ= or NCL= keyword is used. 5.Significance of Output Classes To print this sysout data set and the messages from your job on the same output listing, code one of the following: • The same output class in the DD SYSOUT parameter as in the JOB MSGCLASS parameter. • DD SYSOUT=* to default to the JOB MSGCLASS output class. • DD SYSOUT=(,) to default to one of the following: 1. The CLASS parameter in an explicitly or implicitly referenced OUTPUT JCL statement. In this case, the OUTPUT JCL CLASS parameter should specify the same output class as the JOB MSGCLASS parameter. 2. The JOB MSGCLASS output class, if no OUTPUT JCL statement is referenced or if the referenced OUTPUT JCL statement contains either CLASS= or CLASS=*. 6.Examples of the CLASS Parameter Example //OUTDS6 OUTPUT CLASS=D //OUT1 DD SYSOUT=(,),OUTPUT=*.OUTDS6 In this example, JES processes the sysout data set defined in DD statement OUT1 in output class D. Example In this example, JES processes the sysout data set defined in DD statement OUTPTR in output class H, as specified in the JOB statement MSGCLASS parameter. The same result could be obtained by the following: COLORMAP parameter Parameter Type Keyword, optional Purpose Use COLORMAP to specify the AFP Resource (object) for the data set that contains color translation information. 1.Syntax COLORMAP=resource 2.Subparameter Definition resource Specifies the name of an AFP resource, where the resource name is 1 through 8 alphanumeric or national ($, #, @) characters and the first must be alphabetic or national.

3.Example of the COLORMAP Parameter

//OUTCOLOR OUTPUT COLORMAP=M1SETUP

In this example, M1SETUP is the name of the AFP resource.

COMPACT parameter

Parameter Type

Keyword, optional

Purpose

Use the COMPACT parameter to specify a compaction table for JES to use when sending the sysout data set, which is a systems network architecture (SNA) data set, to a SNA remote terminal.

1.Syntax

COMPACT=compaction-font-name

2.Subparameter Definition

compaction-font-name
Specifies a compaction table by a symbolic name. The name is 1 through 8 alphanumeric characters. The symbolic name must be defined by the installation during JES initialization.

3.Defaults
If you do not code the COMPACT parameter, compaction is suppressed for the data set.

4.Overrides
This parameter overrides any compaction table value defined at the SNA remote terminal.

5.Example of the COMPACT Parameter

//OUTDS8 OUTPUT DEST=N555R222,COMPACT=TBL77

In this example, the sysout data set will be sent to remote terminal 222 at node 555; JES will use compaction table TBL77.

COMSETUP parameter

Parameter Type

Keyword, optional

Purpose

Use the COMSETUP parameter to specify the name of a microfile setup resource that contains setup information.

1.Syntax

COMSETUP=resource

2.Subparameter Definition

resource
Specifies the name of a macrofile setup resource, where the resource name is 1 through 8 alphanumeric or national (\$, #, @) characters. (The first must be alphabetic or national.)

3.Example of the COMSETUP Parameter

//RPTDS OUTPUT COMSETUP=H1SETUP

In this example, H1SETUP is the name of a microfilm setup resource.

CONTROL parameter

Parameter Type

Keyword, optional

Purpose

Use the CONTROL parameter to specify either that each logical record starts with a carriage control character or that the output is to be printed with single, double, or triple spacing.

1.Syntax

CONTROL= {PROGRAM} {SINGLE } {DOUBLE } {TRIPLE }

2.Subparameter Definition

PROGRAM
Indicates that each logical record in the data set begins with a carriage control character, which must be identified in the DD statement, DCB macro, or data set label. You might identify these carriage control characters in the DD statement through the DCB subparameter in the RECFM of the data set as being A (ASA) or M (machine). Using Data Sets.

SINGLE
Indicates forced single spacing.

DOUBLE
Indicates forced double spacing.

TRIPLE
Indicates forced triple spacing.

3.Defaults
In a JES3 system, if you do not code the CONTROL parameter, JES3 uses an installation default specified at initialization.

In a JES2 system, if you do not code the CONTROL parameter, JES2 uses the settings from the device statement in the JES2 initialization deck or the operator command to modify the spacing for that device. This modify device command can set single, double, or triple spacing.

4.Example of the CONTROL Parameter

//OUTDS9 OUTPUT CONTROL=PROGRAM

In this example, the sysout data set is printed using the first character of each logical record for carriage control.

COPIES parameter

Parameter Type

Keyword, optional

Purpose

Use the COPIES parameter to specify how many copies of the sysout data set to print. The printed output is in page sequence for each copy. For printing on an AFP printer, this parameter can instead specify how many copies of each page are to be printed before the next page is printed.

1.Syntax

COPIES= {nnn } {(nnn,(group-value[,group-value]...))} {(,(group-value[,group-value]...)) }
• You can omit the parentheses if you code only COPIES=nnn.
• The following are not valid:
• – A null group-value, for example, COPIES=(5,(,)) or COPIES=(5,)
– A zero group-value, for example, COPIES=(5,(1,0,4))
– A null within a list of group-values, for example, COPIES=(5,(1,,4))

2.Subparameter Definition

nnn
A number (1 through 255 in a JES2 system, 1 through 254 in a JES3 system) that specifies how many copies of the sysout data set to print. Each copy will be in page sequence order.

For a data set printed on an AFP printer, JES ignores nnn if any group values are specified.

group-value
Specifies how many copies of each page are to be printed before the next page is printed. Each group-value is 1 through 3 decimal numbers from 1 through 255 in a JES2 system and from 1 through 254 in a JES3 system. You can code a maximum of eight group-values. Their sum must not exceed 255 or 254. The total copies of each page equals the sum of the group-values.

Note:

• This subparameter is valid only for output processed by PSF.
• For output printed on an AFP printer, this subparameter overrides an nnn subparameter, if coded.

3.Defaults
For JES2, on the DD, OUTPUT JCL, or /*OUTPUT statement: if you do not code a COPIES parameter, code it incorrectly, or code COPIES=0, the system uses a default of 1, which is the default for the DD COPIES parameter.

For JES3, on the DD, OUTPUT JCL, or //*FORMAT statement: if you do not code a COPIES parameter, code it incorrectly, or code COPIES=0 on the DD statement, the system uses a default of 1, which is the default for the DD COPIES parameter.

4.Overrides
A COPIES parameter on the sysout DD statement overrides the OUTPUT JCL COPIES parameter.

If the OUTPUT JCL statement contains a FORMDEF parameter, which specifies a library member, the COPYGROUP parameter on a FORMDEF statement in that member overrides any group-value subparameters on the OUTPUT JCL COPIES parameter or the sysout DD COPIES parameter.

5.Relationship to Other Parameters
If the OUTPUT JCL or the sysout DD statement contains a FLASH parameter, JES prints with the forms overlay the number of copies specified in one of the following:

• COPIES=nnn, if the FLASH count is larger than nnn. For example, if COPIES=10 and FLASH=(LTHD,12) JES prints 10 copies, all with the forms overlay.
• The sum of the group-values specified in the COPIES parameter, if the FLASH count is larger than the sum. For example, if COPIES=(,(2,3,4) and FLASH=(LTHD,12) JES prints nine copies in groups, all with the forms overlay.
• The count subparameter in the FLASH parameter, if the FLASH count is smaller than nnn or the sum from the COPIES parameter. For example, if COPIES=10 and FLASH=(LTHD,7) JES prints seven copies with the forms overlay and three copies without.

6.Relationship to Other Control Statements
For JES2, if you request copies of the entire job on the JES2 /*JOBPARM COPIES parameter and also copies of the data set on the DD COPIES or OUTPUT JCL COPIES parameter, JES2 prints the number of copies equal to the product of the two requests.

7.Examples of the COPIES Parameter

Example

//RPTDS OUTPUT COPIES=4,FORMS=WKREPORT

This example asks JES to print four copies of the weekly report on forms named WKREPORT.

Example

//EXPLD OUTPUT COPIES=(,(3)),FORMS=ACCT

This example asks JES to print the first page three times, then the second page three times, the third page three times, etc., on forms named ACCT.

Example

//QUEST OUTPUT COPIES=(,(8,25,18,80)),FORMS=ANS

This example asks JES to print each page eight times before printing the next page, then 25 times before the next, then 18 times before the next, and finally 80 times before the next. The forms are named ANS.

Example

//EXMP OUTPUT COPIES=(5,(3,2))

This example asks JES to do one of the following:

• If the data set is printed on other than an AFP printer, to print five copies.
• If it is printed on an AFP printer, to print each page three times before printing the next page and then to print each page twice before printing the next page.