GLOBAL statement (IMS compatible JCL)

Control statement syntax

Follow these coding conventions to code GLOBAL statement keywords for the FABJTGEN program:

• A GLOBAL statement consists of a control statement name (GLOBAL) and one or more process option parameters. An option parameter consists of a keyword and an operand. The syntax is as follows:

  Control-Statement blank option-parameter,option-parameter,... 

  For example, the GLOBAL statement in ICEIN data set can be coded as follows:

  //ICEIN    DD *
    TABLEGEN TYPE=IMSJCL
  *
    GLOBAL   HPIO=Y,
             COMP=Y,COMPRTN=FABJCMP2 
  /*

• Only one GLOBAL statement can be specified in the ICEIN data set.
• GLOBAL statement and its option parameters must be coded in columns 2 - 72.
• Control statement name (GLOBAL) must be separated from the first option parameter by one or more blanks.
• Control statement name (GLOBAL) and the first option parameter must be written on the same line.
• When more than one option parameter is specified, they must be separated by a comma (,) and no blanks are allowed between these option parameters.
• Option parameters can be continued to the next control statement line. On the continued line, option parameters can start from column 2.
• The GLOBAL statement must start with a control statement name (GLOBAL) and end with a comma after the option parameter.
• An option parameter is constructed with a keyword and its operand associated value, separated by an equal sign (=). No blanks are allowed before or after the equal sign (=).
• If two or more values are needed to specify the keyword, the set of values must begin with a parenthesis ’(’ and end with a parenthesis ’)’. The values must be separated by a comma.
• A comment must begin with an asterisk (*) in column 1. Or comments can follow the last option parameter on each control statement line, separated by at least one blank.
• GLOBAL statement can contain uppercase alphabetic characters, numeric characters, and the following special characters:
  • Asterisk (*)
  • Comma (,)
  • Equal sign (=)
  • Parenthesis ( )
  • Forward slash (/)

COMP keyword

The COMP keyword specifies whether the Image Copy function compresses output image copy data.

This keyword sets the default value for column 39 of SYSIN data set. The system default value is COMP=N, which means output image copy data is not compressed.

Related keywords

• COMPMODE keyword
• COMPRTN keyword

Format

COMP=Y|N

Y

Compresses output image copy data.

N

Does not compress output image copy data.

COMPMODE keyword

The COMPMODE keyword controls the priority of the compression methods for compressing output image copy data sets. This keyword is effective only when the IDRC feature is activated by the JCL or the system.

This keyword sets the default value for the COMPMODE keyword in EXEC PARM. The system default value is COMPMODE=N, which means when the compression routine is not FABJCMP2, IMS HP Image Copy automatically turns off the software compression and uses IDRC.

The compression methods are determined based on the specifications of the COMP keyword and the COMPRTN keyword. The following table summarizes the IMS HP Image Copy compression features that are applied by each combination of the COMPMODE, COMP, and COMPRTN specifications.

Whether the IDRC feature is activated depends on the z/OS® system definition and on the TRTCH subparameter of the DCB parameter for the output image copy data set DD statement.

If the IDRC feature is activated for the primary image copy data set, the compression routine is ignored for other image copies that are taken from the same database data set.

Related keywords

• COMP keyword
• COMPRTN keyword

Format

COMPMODE=COND|N

COND

If the IDRC feature is active and the compression routine is not FABJCMP2, IMS HP Image Copy automatically turns off IDRC and uses software compression.

N

If the IDRC feature is active and the compression routine is not FABJCMP2, IMS HP Image Copy automatically turns off the software compression and uses IDRC.

COMPRTN keyword

The COMPRTN keyword specifies the name of the compression routine that the Image Copy function invokes to compress output image copy data.

This keyword is effective when COMP=Y is specified.

This keyword sets the default value for column 40 of SYSIN data set. The system default value is COMPRTN=FABJCMP1, which means the Image Copy function uses compression routine FABJCMP1 to compress output image copy data.

Related keywords

• COMP keyword
• COMPMODE keyword

Format

COMPRTN=routine

routine

The name of the compression routine. IMS HP Image Copy provides four compression exit routines: FABJCMP1, FABJCMP2, FABJCMP3, and FABJCMP4.

Specify one of these compression routines. If the COMP=Y keyword is specified without the COMPRTN keyword, FABJCMP1 is used as the default. The same compression routine is automatically called in Recovery function jobs to decompress the compressed data. IMS HP Image Copy provides the compression routines that are shown in the following table.

Table 2. Compression routines of IMS HP Image Copy

Compression routine	Compression algorithm
FABJCMP1	Runs repeated character compression. Free space can also be compressed.
FABJCMP2	Runs only free space compression. Segmented data is not compressed.
FABJCMP3	Runs repeating-characters compression of the z/OS program compression method. Free space might also be compressed.
FABJCMP4	Runs the repeating-characters compression of the z/OS program compression method. This routine runs the block compression, which does not distinguish between the data portion, free space, and unused space in the database.

DBBUF keyword

The DBBUF keyword specifies the number of buffers to be used for accessing the database data set groups or areas.

This keyword sets the default value for the BUFND parameter (for OSAM data sets) or the AMP parameter (for VSAM data sets) that you specify on the datain DD statement. With system's default, IMS HP Image Copy uses the optimized value that is based on the record size or the CI size of the database data sets.

Format

DBBUF=nnnnn

nnnnn

The left-aligned number of buffers used to access database data set groups or areas.

If you specify HPIO=Y, the DBBUF keyword is ignored for OSAM and VSAM ESDS data sets of the database.

DEDBPC keyword

The DEDBPC keyword specifies whether to invoke HASH Check of the DEDB Pointer Checker utility during the execution of the Image Copy function.

This keyword is effective when the executing function is batch image copy or concurrent image copy.

This keyword sets the default value for columns 48 and 49 of SYSIN data set. The system default value is DEDBPC=N, which means DEDB HASH pointer check is not invoked.

Format

DEDBPC=Y|S|N

Y

Invokes DEDB HASH pointer check.

S

Invokes DEDB HASH pointer check and evaluates SSP pointers in the DEDB.

N

Does not invoke DEDB HASH pointer check.

DSBUF keyword

The DSBUF keyword specifies how many buffers are to be used in getting access to the input data set in the Recovery function.

This keyword sets the default value for the BUFND parameter that you specify on the DD statements for the input image copy data set, DFSULOG, and DFSUCUM. The system default value is DSBUF=50, which means 50 buffers are used.

Format

DSBUF=nnnn

nnnn

The left-aligned number of buffers used in getting access to the input image copy data set, the log data set, and the change accumulation data set.

HDPC keyword

The HDPC keyword specifies whether to invoke pointer checking of the HD Pointer Checker utility during the execution of the Image Copy function.

This keyword is effective when the executing function is batch image copy.

This keyword sets the default value for column 48 of SYSIN data set. The system default value is HDPC=N, which means HD Pointer Checker is not invoked.

Format

HDPC=Y|N

Y

Invokes HD Pointer Checker HASH pointer check.

If HDPC=Y is specified for a database that is not supported by HD Pointer Checker HASH Check, an image copy of the database is created but pointer checking is not done.

N

Does not invoke HD Pointer Checker HASH pointer check.

Consideration

HD Pointer Checker HASH pointer check is not supported in the following cases:

• Concurrent image copy process
• Target database is a HALDB and IMS HP Image Copy is scheduled with PGM=DFSRRC00.

HPIO keyword

The HPIO keyword specifies whether to use the HP Input/Output interface to access input database data sets in the Image Copy function.

This keyword sets the default value for the HPIO keyword on EXEC PARM. The system default value is HPIO=N, which means the HP Input/Output interface is not used.

Format

HPIO=Y|N

Y

Specifies to use the HP Input/Output method.

HP Input/Output method is a high performance I/O method that is used by IMS Tools products to access input database data sets. This method can be used when the database data sets are OSAM or VSAM ESDS data sets.

This keyword is ignored when either or both of the following conditions apply:

• IMS HP Image Copy is run by EXEC PGM=DFSRRC00.
• The input database data set is a VSAM KSDS data set.

To specify HPIO=Y, all the load libraries of IMS HP Image Copy and the site default module must be APF authorized.

N

Specifies that standard management methods are used to read database data sets and area data sets.

ICBUF keyword

The ICBUF keyword specifies the number of buffers to be used for accessing output image copy data set.

This keyword sets the default value for the BUFND parameter that you specify on the dataout DD statements. The system default value is ICBUF=50, which means 50 buffers are used.

Format

ICBUF=nnnn

nnnn

The left-aligned number of buffers used to access the output image copy data set.