PSSR JCL requirements

To run a PSSR job, code the EXEC statement and DD statements that satisfy the PSSR JCL requirements.

There are two ways to run PSSR:

As a standard (non IMS™) MVS™ batch job (FABSPSSR procedure)
As a batch job using the IMS environment (FABSPSSI procedure)

The two procedures require different JCL.

The following table lists the DD statements. Explanations of the JCL parameters follow the table.

Table 1. DD statements for PSSR
DDNAME	Use	Format	Needed in MVS Batch?	Needed in IMS environment?
STEPLIB	Input	PDS	Required	Required
SORTIN	Input	RECFM=VB	Required	Required
SORTCNTL	Input	LRECL=80	Not Applicable	Optional
SYSIN	Input	LRECL=80	Required	Not Applicable
CTL	Input	LRECL=80	Required	Required
PSSRIN	Input	LRECL=80	Optional	Optional
IMS	Input	PDS	Required	Required
IMS2	Input	PDS	Required	Required
SORTOUT	Output		Required	Required
SORTOUT2	Output		Optional	Optional
SORTOUT3	Output		Optional	Optional
SORTOUT4	Output		Not Applicable	Optional
SORTOUTD	Output		Optional	Optional
`Output partition data set`	Output		Not Applicable	Optional
SYSOUT	Output	SYSOUT	Required	Required
PR8	Output	LRECL=133	Required	Required
PR9	Output	LRECL=133	Required	Required
PR9X	Output	LRECL=133	Required	Required
PR10	Output	LRECL=133	Not Applicable	Optional
SYSUDUMP	Output	SYSOUT	Optional	Optional
SORTWK`nn`	Work data set		Required	Required
HDHEADER	Work data set	BLKSIZE=60	Required	Required
RECON`x`	Input/Output		Not Applicable	Optional
DFSRESLB	Input	PDS	Not Applicable	Optional
SYSPRINT	Output	SYSOUT	Not Applicable	Optional

EXEC

This statement must have one of the following forms:

For an MVS batch
```
  //     EXEC  PGM=SORT,REGION=xxxxK
```
For an IMS environment batch
```
  //     EXEC  PGM=FABSMAIN,REGION=xxxxK,
               PARM=(IMSPLEX=IMSplex_name,DBRCGRP=ccc)
```
Specify FABSMAIN as the program name. The name is mandatory for the IMS environment. The PARM= parameter is optional, and its keyword are:
IMSPLEX=IMSplex_name

Specifies the 1- to 5-character IMSplex name that is used by IMS DBRC SCI Registration.

DBRCGRP=ccc

Specifies the 3-character DBRC group identifier that is used by IMS DBRC SCI Registration.

For HALDB processing, an IMS environment batch is required. For non-HALDB processing in an environment where DBRC=FORCE, an IMS environment batch cannot be used.

STEPLIB DD

This statement defines the data set that contains the PSSR, DFSORT, and IMS program modules.

If you specify the use of DATXEXIT or a segment edit/compression exit for PSSR, you must include it in this data set.

If the input database is a HALDB, which uses a partition selection exit, you must include the partition selection exit routine in the input RECON definitions in this data set.

SORTIN DD

This input data set is the sequential data set that contains the unloaded database. It is created by the IMS HD Reorganization Unload utilities or an equivalent program. The acceptable format of unloaded database data set is the HD, the *SH format, or the communication industry standard format (*CS). The *CS or *SH format data set are created by the unload utilities of IMS High Performance Unload. The record format must be VB no matter whether the data is fixed or variable in length.

Restriction: The *CS format is not supported when the input DBD is defined as a HALDB.

SYSIN DD

This input data set is required only in the MVS batch. This input data set contains DFSORT control statements. It is not needed in the IMS environment.

SORTCNTL DD

This input data set is optional in the IMS environment. It contains DFSORT control statements. It is not needed in the MVS batch.

CTL DD

This input data set contains your specification of the processing to be done by PSSR. It specifies the databases that will be reloaded, and it can contain requests you want to make for the database or partitions of HALDB.

PSSRIN DD

This input data set contains your specification for an unloaded file format, a user exit, and a DATXEXIT for PSSR.

The user exit and the DATXEXIT are not applicable to the MVS batch.

IMS DD

This input data set is a library that contains your DBD load modules. It must contain the DBD of the database being reloaded.

IMS2 DD

This input data set is a library that contains the PSSR routines, the user-supplied HDAM randomizing routines, the user-supplied partition selection exit routines that are specified in the CTL control statement, and the user-supplied user exit routines.

When the PSSR job runs under the MVS Batch environment, FABSRT15, FABSRT35, and other PSSR modules need to be included in the IMS2 data set.

Requirement: If you specify any of the partition selection parameters in a PSSR CTL statement, you must include the partition selection exit routine in the IMS2 data set.

SORTOUT DD

This output data set is a sequential data set that contains most (or all) of the unloaded database records. Its format must be identical to that of the SORTIN data set. It contains all of the database segments that are intended to be completely loaded into the root addressable area. These database records are sorted into their physical sequence (as it will be after the database is reloaded).

For HALDB, this output data set contains all of the segment records that are not put into output partition data sets. The records are stored in groups of partitions in the order of the partition selection sequence.

The records are stored in a partition in the order of physical sequence.

The partition selection sequence is in high key sequence or in another sequence that is specified by the user-supplied partition selection exit.

SORTOUT2 DD

This output data set is the sequential data set that contains all of the unloaded database records that are not in the SORTOUT data set. These records must be in the same format as they were on the SORTIN data set.

For HDAM, this data set cannot be used as an input for the reload processing that is done by IMS High Performance Load for z/OS® Version 2 Release 1 or later. For details, see Considerations before using PSSR.

For PHDAM, this data set is used as a work data set for PSSR. You must not reload the segments in this data set. Rather, define this data set as a temporary data set in your PSSR job step when you process HALDB.

For HIDAM or PHIDAM, no data is contained in this data set.

If the SORTOUT3 data set is specified, the database records whose root segment received a return code 4 from the randomizing routine are written into the SORTOUT3 data set instead of this data set.

SORTOUT3 DD

This optional data set is a sequential data set that contains database records whose root segment received a return code 4 from the randomizing routine. These records must be in the same format as they were in the SORTIN data set.

Following is an example of this statement for the IBM® supplied cataloged procedure that is shown in Figure 1.

//SORTOUT3  DD DSNAME=&&UNLSRT3,DISP=(NEW,PASS,DELETE),
//             SPACE=(CYL,(&CYL)),UNIT=&SUNIT,
//             VOLUME=SER=&SVOL,DCB=&IMSHDUN

SORTOUT4 DD

This optional output data set is unique to HALDB. It is a sequential data set that contains database records of root segments that received a nonzero return code from the partition selection. These records must have the same format as in the SORTIN data set.

SORTOUTD DD

This output data set is optional. If it is specified and the root key is defined as unique in the DBD, PSSR checks the root key duplications and stores the duplicated database records into this data set. These records must have the same format as in the SORTIN data set.

Output partition data set DD

This output data set is optional and unique to HALDB. It is a sequential data set that contains all the segment records that must be reloaded into a partition. The name of DD is the partition name that is defined in RECON data sets.

By specifying the DD names for all partitions of your HALDB, you can split your unloaded database data set into a set of partition data sets.

SYSOUT DD

This output data set contains the messages that are produced by DFSORT.

PR8 DD

This output data set contains the reports that are produced by PSSR. The partition information is printed for HALDB. If BLKSIZE is coded on the DD statement, it must be a multiple of 133.

PR9 DD

This output data set contains reports that are produced by PSSR. The partition information is printed for HALDB. If BLKSIZE is coded on the DD statement, it must be a multiple of 133.

PR9X DD

This output data set contains reports that are produced by PSSR. The partition information is printed for HALDB. If BLKSIZE is coded on the DD statement, it must be a multiple of 133.

PR10 DD

This output data set is optional and unique to HALDB. It contains the reports that are produced by PSSR. If BLKSIZE is coded on the DD statement, it must be a multiple of 133.

SYSUDUMP DD (or SYSABEND)

This DD statement defines output from a system abend dump routine. The statement is used only for debugging, when a dump is required.

SORTWKnn DD

These DD statements are for intermediate storage data sets used by DFSORT. See the DFSORT Application Programming Guide for more information about how to code SORTWKnn DD statements.

HDHEADER DD

This DD statement is for an intermediate data set that is created by module FABSRT15 or FABSPE15, and used by module FABSRT35 or FABSPE35. If BLKSIZE is coded on the DD statement, it must be a multiple of 60.

RECON1 DD, RECON2 DD, RECON3 DD

These DD statements are for the RECON data sets. The DD statements are required when PSSR processes HALDB and when RECON data sets are not allocated dynamically.

DFSRESLB DD

This input data set is required in the IMS environment. It contains the IMS load modules.

SYSPRINT DD

This output data set is required in the IMS environment. It contains the messages that are issued by IMS.