GI11-9492-01

JCL statements for compiling text format Xerox JSL resources

Infoprint XT provides sample JCL that you can modify to compile text format Xerox JSL resources. Infoprint XT provides the sample JCL in the SAIOSAMP data set. Sample JCL for compiling text format Xerox JSL resources shows the sample JCL that Infoprint XT provides.

Sample JCL for compiling text format Xerox JSL resources

//AIOZPDLT  JOB <JOB STATEMENT PARAMETERS>
//********************************************************************* 
//*    Licensed Materials - Property of IBM                           * 
//*    5655-O15                                                       * 
//*    (C) Copyright IBM Corp. 2012                                   * 
//*                                                                   * 
//*  This job compiles text format Xerox JSL resources.               *
//*                                                                   * 
//*  CAUTION: This is neither a JCL procedure nor a complete          * 
//*  job.  Before using this job step, you must make these            * 
//*  modifications:                                                   * 
//*                                                                   * 
//*  1) Change the JOB statement to meet your system requirements.    * 
//*                                                                   * 
//*  2) Change hlq on the XRSPDS DD to identify the data set          *
//*     containing text format Xerox JSL (K$*) resources.             * 
//*                                                                   * 
//*  3) Modify the SYSIN DD parameters as desired.                    *
//*                                                                   *
//*  4) Modify the SELECT DD parameters as desired.                   *
//*                                                                   *
//*  5) Ensure you run this job from a user ID that is in the         *
//*     AIOUSER group.                                                *
//*                                                                   *
//*********************************************************************
//* 
//AIOZPDLT EXEC PGM=AIOZPDL                                            
//*                                                                    
//*********************************************************************
//* Diagnostic messages from the pdxtpdl command                      *
//*********************************************************************
//*                                                                    
//SYSPRINT DD   SYSOUT=*                                               
//*                                                                    
//*********************************************************************
//* PDS (RECFM=FB, LRECL=80) containing Xerox JSL resources as text   *
//* format files                                                      *
//*********************************************************************
//*                                                                    
//XRSPDS   DD   DSN=hlq.SRCLIB,DISP=SHR                                
//*                                                                    
//*********************************************************************
//* Specify processing options                                        *
//*********************************************************************
//*                                                                    
//SYSIN    DD   *                                                      
*                                                                      
* Specify a resource group (optional):                                 
*                                                                      
* -g my_group                                                          
*                                                                      
/*                                                                     
//*                                                                    
//*********************************************************************
//* Specify resources to process                                      *
//*********************************************************************
//*                                                                    
//SELECT   DD   *                                                      
  *.jsl                                                                
/*                                                                     
//*                                                                    
//*********************************************************************
//* To collect service data:                                          *
//*                                                                   *
//* 1) Uncomment the following DD.                                    *
//*                                                                   *
//* 2) Change hlq to an appropriate high level qualifier for your     *
//*    system.                                                        *
//*                                                                   *
//* 3) Change volser to an appropriate volume name for your system.   *
//*********************************************************************
//*                                                                    
//*DEBUG    DD   DSN=hlq.PDXT.AIOZPDLT.PAX,                            
//*           UNIT=SYSDA,VOL=SER=volser,                               
//*           SPACE=(TRK,(450,90),RLSE),                               
//*           DCB=(LRECL=80,BLKSIZE=27920,RECFM=FB),                   
//*           DISP=(NEW,CATLG,CATLG)

These describe the various statements in the sample JCL:

AIOZPDLT JOB
This required JOB statement marks the beginning of the job. It tells the system how to process the job through the positional and keyword parameters of the statement. Replace AIOZPDLT with the appropriate job name. Replace the <JOB STATEMENT PARAMETERS> portion of the sample statement with any parameters that your installation requires.
AIOZPDLT EXEC
This required EXEC statement specifies the Infoprint XT AIOZPDL utility program.
SYSPRINT DD
This DD statement defines the data set where AIOZPDL writes the standard error from the pdxtpdl command (file descriptor 2).
XRSPDS DD
This DD statement specifies the name of a PDS containing text format Xerox JSL resources that you wish to compile. You can either allocate the PDS externally, through the ISPF Data Set Utility, or you can include specific parameters in the JCL. In either case, the PDS characteristics must include RECFM=FB, LRECL=80, and BLKSIZE=nnnnn. The numeric value, nnnnn, is the largest efficient size, and is a multiple of 80. This is an example of how you could allocate the data set on the XRSPDS DD statement: 
//XRSPDS DD DSN=yourid.SRCLIB,
//          UNIT=SYSDA,VOL=SER=vvvvvv,
//          SPACE=(TRK,(180,5,90),RLSE),
//          DCB=(RECFM=FB,LRECL=80,BLKSIZE=27920),
//          DISP=(NEW,CATLG,CATLG)
SYSIN DD
This optional DD statement specifies the AIOZPDL parameters. You can specify a sequential data set that contains the parameters, or you can specify the parameters directly in the DD statement. When it builds the parameter list from the information that you specify, AIOZCLS uses the same rules that AIOZR2AR uses for the SYSIN DD statement. See SYSIN DD for AIOZR2AR.
Notes:
  1. If the SYSIN DD statement is present, Infoprint XT attempts to use the parameters it specifies.
  2. If the JCL contains a SYSIN DD DUMMY statement, or if the SYSIN DD specifies an empty data set, Infoprint XT uses the AIOZPDL default parameters.
  3. Because AIOZPDL automatically specifies the pdxtpdl -l option, you cannot specify the -n option in the SYSIN DD parameters. The -l and -n options are mutually exclusive.
SELECT DD
This optional DD statement specifies the names of the Xerox JSL resources, in the Xerox xrname.ext format, that you want to compile. You can either specify a sequential data set that contains the resource names, or you can specify the names directly in the DD statement.
To specify resource names with wildcard characters, follow these guidelines:
  • Use an asterisk (*) to represent a series of characters.
  • Use a question mark (?) to represent a single character.
  • Use a wildcard character in the resource extension; however, do not use a wildcard character to represent the period between the resource name and the resource extension.
You can specify one or more resource names or resource patterns on a single line. Separate each name or pattern with one or more spaces. You can also use multiple lines to specify resources. Infoprint XT ignores any resource information in columns 73 through 80. This example shows how you can specify resources: 
//SELECT DD *
  TEST*.JSL ?PROD.JSL
  POLICY.JSL
  *.JSL
/*

You can include comments within the list of resources. Infoprint XT recognizes any line that begins with an asterisk in column one as a comment.

If you do not specify the SELECT DD statement, Infoprint XT attempts to load any resources that failed to load on the last invocation on the AIOZPDL utility program.

Note: When Infoprint XT issues messages for the resource-compile process, it refers to the resource patterns or resource names that you specify as the SELECT criteria.
DEBUG DD
This DD statement provides a method of capturing service information. An IBM® service representative provides directions for its use. For details about capturing service information, see Capturing service information.
Parent topic: Using the AIOZPDL utility to compile Xerox JSL resources