Reason code associated with SSOBRETN value of SSS2LERR or SSS2BDIS. See the explanation at Reason Codes for SSOBRETN being SSS2LERR and Reason Codes for SSOBRETN being SSS2BDIS.

JES token associated with this SAPI request. A zero value here implies that this is a new request. A new request implies that the SSS2DSN is null.

The application, once originally initializing this field to X'00's, must not modify or subsequently reference this field.

Address of a JES initialized data area (a dynamic allocation text unit). This value must be copied to a dynamic allocation text unit pointer by the application thread prior to the dynamic allocation of the returned data set.

See PUT/GET Requests for information concerning programming considerations related to the use of SSS2BTOK.

Total number of copies requested by creator. A data set is returned through this interface only once no matter how many copies were requested by the creator.

Copy groups

Jobname of selected job

Job ID of selected job

Original jobid of selected job. (Original id may be different from current jobid.) (JES3 always returns blanks.)

Creator user ID of data set selected

JCL definition vector table

PRMODE of data set selected

Destination of selected data set

Writer name of selected data set

Form number of selected data set

Transaction Program Jobname that created this data set

Transaction Program Job ID that created this data set

Data set name of selected data set. Must be blanks or zeros if SSS2JEST is zero.

You must not make assumptions regarding the format of the data set name.

Segment id (zero if data set not segmented)

SWB processing error - reason code set to non-zero only if SSS2WRTN is non-zero

SYSOUT class of selected data set

Maximum logical record length (LRECL)

DSID for the selected data set. The value is derived from the value specified as the DSID keyword on a DD statement, which is only used for 3540 Diskette data sets.

SSS2GNVA

JES returned an output group name in SSS2OGNM (JES2 only).

SSS2DSCL

Line count, page count, byte count, and record count (SSS2LNCT, SSS2PGCT, SSS2BYCT, and SSS2RCCT) are accurate. This bit will not be on if there was an abnormal termination or the data was created on a different node.

SSS2DSF

First data set in output group

SSS2DSC

Output group being continued

SSS2DSL

Last data set in output group

SSS2IP

An Internet Protocol (IP) destination is available in the SJF data. See SSS2SWBT and SSS2SWTU.

SSS2BRST

BURST=YES specified

SSS2OPTJ

OPTCD=J specified

SSS2NCHR

Selection using printer translation tables not supported

SSS2NVOL

Selecting output based on a volume serial list not supported

SSS2NNHD

Returning addresses of NJE headers not supported

SSS2NMOD

Selecting output based on a modification is not supported

SSS2NPRI

Selecting output in priority order is not supported

SSS2NIPA

IP address selection not supported. Turned on if JES does not support and SSS2SIPA or SSS2SIPN is on

SSS2RSTC

Data set created by started task

SSS2RTSU

Data set created by time sharing user

SSS2RJOB

Data set created by batch job

SSS2CPDS

Data set has page mode data

SSS2SPUN

Data set was spun at close

SSS2SDSH

All data sets in group must be unallocated identically.

SSS2RHLV

Data set on "HOLD/LEAVE" queue (JES2) or "Hold for TSO" queue (JES3)

SSS2RXWH

Data set on "Hold for XWTR" queue. This will never be true in a JES2 environment.

SSS2RHOL

Data set on one of the held queues.

SSS2RWTR

Data set on "Write/Keep" queue (JES2) or "Writer" queue (JES3).

SSS2RFOR

Record format

Line count

For a PUT/GET request, this value is for the single returned data set. For a COUNT request, this value represents the sum of all the data sets that have been selected for the count, not taking individual copies requested of these data sets into effect.

Page count

For a PUT/GET request, this value is for the single returned data set. For a COUNT request, this value represents the sum of all the data sets that have been selected for the count, not taking individual copies requested of these data sets into effect.

Byte count after blank truncation

For a PUT/GET request, this value is for the single returned data set. For a COUNT request, JES2 does not return this value. Meanwhile, for JES3 this value represents the sum of all the data sets that have been selected for the count, not taking individual copies requested of these data sets into effect.

Spool record count (JES3 only)

For a PUT/GET request, this value is for the single returned data set. For a COUNT request, this value represents the sum of all the data sets that have been selected in the count, not taking individual copies of these data sets into effect.

Procname for the step creating this data set

Stepname for the step creating this data set

DDNAME for the data set creation

Token used for SJFREQ services. This field is filled in if flag SSS2FSWB is set.

See PUT/GET Requests for programming considerations concerning the use of the SSS2SWBT field.

Address of the SWBTU block. This field is filled in if flag SSS2FSWT or SSS2FSWB is set.

See PUT/GET Requests for programming considerations concerning the use of the SSS2SWTU field.

Copied to and from SAPPRIV if JES2, COWPRIV if JES3.

Printer translate table 1

Printer translate table 2

Printer translate table 3

Printer translate table 4

JES2 output group name

The data set returned with a given output group name will not necessarily continue to have the given output group name if this request keeps the data set.

This field is valid only if SSS2GNVA is on in SSS2RET1.

Printer copy modify image

Printer table reference character

Printer flash cartridge ID

Number of flash copies

Data set priority

Lines/page (JES2 only)

Date and time of data set availability in TOD format (that is, this value is the high order word of the TOD clock obtained through a STCK machine instruction.)

Count of work units (JOEs/OSEs) that match the selection criteria.

Address of NJE data set header. This field is non-zero if a data set header is available and the SSS2NJEH flag is on.

Forms control buffer (FCB). Set to asterisks ('****') if the default FCB is returned.

Universal character set (UCS). Set to asterisks ('****') if the default UCS is returned.

Address of a token that can be used in a subsequent PUTGET call (SSS2PUGE in SSS2TYPE) to get the same data set. SSS2DSTR is filled in by JES after the token is constructed. After processing the data set, JES constructs the data set token in storage controlled by JES. JES then moves the address of the token into the field, SSS2DSTR. JES then returns the IAZSSS2 parameter list to the application. To have the token available for use on a refetch, the user must save the entire token in storage controlled by the user. When re-fetching the data set, SSS2CTKN must point to the entire saved token and SSS2SCTK bit must be turned on in flag, SSS2SEL5. Note that the token has a length defined by the field, CTKNSIZE, in IAZCTKN.

• The identifier is a value assigned by JES3 based on the work selection output characteristics of a SYSOUT data set.
• For a job, SYSOUT data sets with identical work selection output characteristics are assigned the same value.
• The assigned values are unique to the job and cannot be used across jobs.
• The value of the identifier does not affect the order of returned data sets.