Optional Parameters

CHARACTER|DUMP|HEX

specifies the format of the listing.

For the CHARACTER and DUMP parameters, setting the GRAPHICS parameter of the PARM command determines which bit patterns print as characters. See PARM Command for more information.

Note: When you print non-VSAM variable length records, the 4-byte record descriptor word (RDW) that appears at the beginning of each record is not printed.

CHARACTER: specifies that each byte in the logical record is to be printed as a character. Bit patterns not defining a character are printed as periods. Key fields are listed in character format (see Figure 1). CHARACTER must be specified if data contains DBCS characters. DUMP and HEX cannot be specified with DBCS.
Abbreviation: CHAR
DUMP: specifies that each byte in the logical record is to be printed in both hexadecimal and character format. In the character portion of the listing, bit patterns not defining a character are printed as periods. Key fields are listed in hexadecimal format (see Figure 1).
HEX: specifies that each byte in the logical record is to be printed as two hexadecimal digits. Key fields are listed in hexadecimal format (see Figure 1).

DBCS

specifies that the data to be printed includes DBCS characters. Bytes from the logical record are printed in their respective characters (that is, SBCS or DBCS format). Bit patterns not defining a character are printed as periods. When DBCS is specified, PRINT checks during printing to ensure that the DBCS data meets DBCS criteria unless SKIPDBCSCHECK or NODBCSCHECK is also specified. For more information on DBCS support, see z/OS DFSMS Using Data Sets.

FROMKEY(key)|FROMADDRESS(address)|

FROMNUMBER(number)|SKIP(number)

locates the data set being listed where listing is to start. If you do not specify a value, the listing begins with the first logical record in the data set or component.

The only value that can be specified for a SAM data set is SKIP.

Use FROMADDRESS and TOADDRESS to specify a partial print range for a linear data set cluster. If required, printing is rounded up to 4096-byte boundaries.

The starting delimiter must be consistent with the ending delimiter. For example, if FROMADDRESS is specified for the starting location, use TOADDRESS to specify the ending location. The same is true for FROMKEY and TOKEY, and FROMNUMBER and TONUMBER.

FROMKEY(key)

specifies the key of the first record you want listed. You can specify generic keys (that is, a portion of the key followed by *). If you specify generic keys, listing begins at the first record with a key matching that portion of the key you specified.

You cannot specify a key longer than that defined for the data set. If you do, the listing is not done. If the specified key is not found, the next higher key is used as the starting point for the listing.

FROMKEY can be specified only when an alternate index, a key-sequenced VSAM data set, a catalog, or an indexed sequential (ISAM) non-VSAM data set is being printed.

key: can contain 1 to 255 EBCDIC characters. A key ending in X'5C' is processed as a generic key.

Abbreviation: FKEY

FROMADDRESS(address)

specifies the relative byte address (RBA) of the first record you want printed. The RBA value must be the beginning of a logical record. If you specify this parameter for a key-sequenced data set, the listing is in physical sequential order instead of in logical sequential order.

FROMADDRESS can be specified only for VSAM key-sequenced, linear, or entry-sequenced data sets or components. FROMADDRESS cannot be specified when the data set is accessed through a path or for a key-sequenced data set with spanned records if any of those spanned records are to be accessed.

address: Can be specified in decimal (n) or hexadecimal (X'n'). The specification cannot be longer than one fullword when specified in decimal.
The largest address you can specify in decimal is 4,294,967,295. If a higher value is required, specify it in hexadecimal.

Abbreviation: FADDR

FROMNUMBER(number)

specifies the relative record number of the first record you want printed. FROMNUMBER can only be specified for VSAM relative record data sets.

number: Can be specified in decimal (n), hexadecimal (X'n'), or binary (B'n'). The specification cannot be longer than one fullword.
The largest address you can specify in decimal is 4,294,967,295. If a higher value is required, specify it in hexadecimal.

Abbreviation: FNUM

SKIP(number)

specifies the number of logical records you want to skip before the listing of records begins. For example, if you want the listing to begin with record number 500, you specify SKIP(499). SKIP should not be specified when you are accessing the data set through a path; the results are unpredictable.

INSERTSHIFT((offset1 offset2)[(offset1 offset2)...])|INSERTALL

If DBCS is specified without INSERTSHIFT nor INSERTALL, the logical record is assumed to already contain SO and SI characters. PRINT will check during printing to ensure that the DBCS data meets DBCS criteria.

INSERTSHIFT((offset1 offset2)[(offset1 offset2)...])

indicates that SO and SI characters are to be inserted in the logical record during PRINT command processing. This action has no effect on the data set referenced by PRINT. This keyword cannot be specified unless DBCS is also specified.

offset1: Indicates the byte offset in the logical record to be printed before which a SO character is to be inserted.
offset2: Indicates the byte offset in the logical record to be printed after which an SI character is to be inserted. offset2 must be greater than offset1 and the difference must be an even number.
Offset pairs cannot overlap ranges.

The maximum number of offset pairs that can be specified is 255.

Abbreviation: ISHFT

INSERTALL

indicates the logical record is assumed to contain only DBCS characters. An SO character is inserted at the beginning of the record and an SI character is inserted at the end of the record.

Abbreviation: ISALL

OUTFILE(ddname)

identifies a target data set other than SYSPRINT. For ddname, substitute the name of the JCL statement that identifies the alternate target data set.

The access method services target data set for listings, identified by the ddname SYSPRINT, is the default. The target data set must meet the requirements stated in JCL DD Statement for a Target Data Set.

Abbreviation: OFILE

SKIPDBCSCHECK((offset1 offset2)[(offset1 offset2)...])|NODBCSCHECK

SKIPDBCSCHECK((offset1 offset2)[(offset1 offset2)...])

indicates that characters between offset1 and offset2 are not to be checked for DBCS criteria during PRINT command processing. This keyword cannot be specified unless DBCS is also specified.

offset1: Indicates the byte offset in the logical record to be printed at which checking is to cease until offset2 is reached.
offset2: Indicates the byte offset in the logical record after which checking is to resume. offset2 must be greater than offset1.
Offset pairs cannot overlap ranges.

The maximum number of offset pairs that can be specified is 255.

Abbreviation: SKDCK

NODBCSCHECK

specifies that DBCS validity checking not be performed.

Abbreviation: NODCK

TOKEY(key)|TOADDRESS(address)| TONUMBER(number)|COUNT(number)

locates the data set being listed where you want the listing to stop. If you do not use this, the listing ends with the logical end of the data set or component.

The only value that can be specified for a SAM data set is COUNT.

Use FROMADDRESS and TOADDRESS to specify a partial print range for a linear data set cluster. The location where the listing is to stop must follow the location where the listing is to begin.

The ending delimiter must be consistent with the starting delimiter. For example, if FROMADDRESS is specified for the starting location, use TOADDRESS to specify the ending location. The same is true for FROMKEY and TOKEY, and FROMNUMBER and TONUMBER.

TOKEY(key)

specifies the key of the last record to be listed. You can specify generic keys (that is, a portion of the key followed by *). If you specify generic keys, listing stops after the last record is listed whose key matches that portion of the key you specified. If you specify a key longer than that defined for the data set, the listing is not done.

If the specified key is not found, the next lower key is used as the stopping point for the listing.

TOKEY can be specified only when an alternate index, a key-sequenced VSAM data set, a catalog, or an indexed sequential (ISAM) non-VSAM data set is being printed.

key: Can contain 1 to 255 EBCDIC characters. A key ending in X'5C' is processed as a generic key.

TOADDRESS(address)

specifies the relative byte address (RBA) of the last record you want listed.

Unlike FROMADDRESS, the RBA value does not need to be the beginning of a logical record. The entire record containing the specified RBA is printed. If you specify this parameter for a key-sequenced data set, the listing is in physical sequential order instead of in logical sequential order.

TOADDRESS can be specified only for VSAM key-sequenced, linear or entry-sequenced data sets or components. TOADDRESS cannot be specified when the data set is accessed through a path. TOADDRESS cannot be specified for a key-sequenced data set with spanned records if any of those spanned records are to be accessed.

address: Can be specified in decimal (n) or hexadecimal (X'n'). The specification cannot be longer than one fullword when specified in decimal.
The largest address you can specify in decimal is 4,294,967,295. If a higher value is required, specify it in hexadecimal.

Abbreviation: TADDR

TONUMBER(number)

specifies the relative record number of the last record you want printed. TONUMBER can be specified only for a VSAM relative record data set.

number: Can be specified in decimal (n), hexadecimal (X'n'), or binary (B'n'). The specification cannot be longer than one fullword.
The largest address you can specify in decimal is 4,294,967,295. If a higher value is required, specify it in hexadecimal.

Abbreviation: TNUM

COUNT(number)

specifies the number of logical records to be listed. COUNT should not be specified when you are accessing the data set through a path; the results are unpredictable.

address or number

can be specified in decimal (n), hexadecimal (X'n'), or binary (B'n'); the specification cannot be longer than one fullword.

The largest address you can specify in decimal is 4,294,967,295. If a higher value is required, specify it in hexadecimal.

RLSSOURCE(NO|YES|QUIESCE)

Specifies how the source dataset will be open.

NO

indicates the source data set will be opened using Non-Shared Resources (NSR).

Abbreviation: N

Default: NO

YES

indicates that the source data set will be opened using Record Level Sharing (RLS), and the data set will have consistent read integrity.

Abbreviation: Y

QUIESCE

indicates that the source data set is quiesced before AMS calls VSAM for RLS OPEN. VSAM switches the data set out of RLS mode and ultimately open it in nonRLS mode.

Abbreviation: Q

Abbreviation: RLSS

Note: If the request is to PRINT a user catalog, and the user catalog is in RLS mode, for example, defined with RLSENABLE, than the following needs to be noted:

ACBERFLG 181 is expected, if RLSSOURCE(YES) option is specified for INDATASET.