beautypg.com

Chapter 6. using acif in os/390, mvs, vm, and vse, Using acif in the os/390 and mvs environments, Explaining the jcl statements – IBM S544-5285-01 User Manual

Page 101

background image

Chapter 6. Using ACIF in OS/390, MVS, VM, and VSE

This chapter describes how to invoke ACIF in the OS/390, MVS, VM, and VSE
environments.

Using ACIF in the OS/390 and MVS Environments

Figure 20 contains sample JCL to invoke ACIF to process print output from an
application.

//USERAPPL EXEC PGM=user application
//PRINTOUT DD DSN=print file,DISP=(NEW,CATLG)
//ᑍ
//ACIF

EXEC=APKACIF,PARM=[[ 'PARMDD=ddname ][,MSGDD=ddname']],REGION=3M

//INPUT DD DSN=ᑍ.USERAPPL.PRINTOUT
//OUTPUT DD DSN=output file,DISP=(NEW,CATLG),
//

DCB=(LRECL=32756,BLKSIZE=3276 ,RECFM=VBA,DSORG=PS),

//

SPACE=(3276 ,(nn,nn)),UNIT=SYSDA

//RESOBJ DD DSN=resource file,DISP=(NEW,CATLG),
//

DCB=(LRECL=32756,BLKSIZE=3276 ,RECFM=VBA,DSORG=PS),

//

SPACE=(3276 ,(nn,nn)),UNIT=SYSDA

//INDEX

DD DSN=index file,DISP=(NEW,CATLG),

//

DCB=(LRECL=32756,BLKSIZE=3276 ,RECFM=VBA,DSORG=PS),

//

SPACE=(3276 ,(nn,nn)),UNIT=SYSDA

//SYSPRINT DD SYSOUT=ᑍ
//SYSIN

DD ᑍ

ACIF parms go here

Figure 20. Sample OS/390 and MVS JCL to Invoke ACIF

Explaining the JCL Statements

The JCL statements in Figure 20 are explained as follows. For more information
about programming JCL, refer to

OS/390 MVS JCL Reference.

USERAPPL

Represents the job step to run the application that produces the actual print
output.

USERAPPL or user application is the name of the program that

produces the print data set.

PRINTOUT

The DD statement that defines the output data set produced from the
application. The application output cannot be spooled to the Job Entry
Subsystem (JES), because ACIF does not read data from the spool. The

print

file is the name of the print data set created by the user application.

ACIF

Represents the job step that invokes ACIF to process the print data set. You
can specify two optional input parameters to ACIF:

PARMDD

Defines the DDname for the data set containing the ACIF processing
parameters. If PARMDD is not specified, ACIF uses SYSIN as the default
DDname and terminates processing if SYSIN is not defined.

Copyright IBM Corp. 1993, 1999

81