This example shows JES3 statements for a CA View ACIF archiver.
Place these statements in SYS1.PARMLIB.
FSSDEF,TYPE=WTR,FSSNAME=VBRMFSSS,PNAME=CVRMSFSS
DEVICE,JNAME=PRT1,DTYPE=SARACIF,MODE=FSS,
PM=ACIF,WS=(PM),HEADER=NO
A sample PROC is in CAI.CVDEPROC.
The FSSDEF initialization parameter defines an FSS to JES3. The following explanations of the JES3 initialization statements are used in the definition of the CA View ACIF archivers. The syntax is as follows:
FSSDEF Statement
The FSSDEF initialization statement is optional, but recommended. If it is omitted, JES3 generates a default for that archiver. The FSSDEF statement can contain the following parameters:
Specifies that the FSS is an output writer for deferred printing (TYPE=WTR).
This parameter is required.
Defines the unique 1- to 8-character name of an FSS.
This parameter is required.
Defines a procedure for starting a specific CA View ACIF FSS.
The procedure (which must be defined before that FSS is started) is a member of the procedure library defined by the STCPROC parameter of the STANDARDS statement, or of the IATPLBST procedure library (the default). Different FSSDEF initialization parameters can refer to the same startup procedure.
The JES3 processor on which the FSS runs.
The name must be the same as specified on the NAME parameter of the MAINPROC statement for the processor.
YES specifies that the FSS is terminated if the JES3 global address space terminates by a *RETURN or *DUMP operator command.
A DEVICE statement is required for each archival FSA. The DEVICE parameters create JES3 default values that are used unless other values are specified in the JCL application program. The DEVICE statement can contain the following parameters:
Indicates a parameter that is ignored by CA View ACIF, but must be specified.
Any name can be used.
Specifies a unique FSS for this CA View ACIF archiver DEVICE statement.
The value must match the value coded for the FSSNAME parameter in the corresponding FSSDEF statement. This parameter is required.
Indicates that no data set header pages are printed.
Indicates the 1- to 8-character name of the CA View ACIF archiver FSA.
Each archiver FSA must have a unique JNAME. This JNAME must correspond to the name on the DEVICE DD statement in the procedure for starting the CA View ACIF FSS. This parameter is required.
Specifies the JUNIT = (,,,OFF) for CA View ACIF archival.
Indicates that the archiver is managed by an FSS.
This parameter is required.
Defines the work selection criteria.
The options are:
Specifies selection by SYSOUT class.
Specifies selection by process mode.
This PROC specifies initialization parameters and libraries that contain system and installation resources for the CA View ACIF archiver.
Before starting a CA View ACIF archiver, ensure you have a cataloged startup PROC in SYS1.PROCLIB or a procedure library concatenated to it. Use the sample JCL for CA View ACIF startup procedure in the next section as a guide.
//VIEWFSS EXEC PGM=SARFSS,TIME=1440,REGION=2M //STEPLIB DD DISP=SHR,DSN=CAI.CVDELOAD // DD DISP=SHR,DSN=ACIF.LOADLIB <== IBM ACIF LOADLIB //* DD DISP=SHR,DSN=CAI.SPOOL.CBQ4LOAD <== CA SPOOL LOADLIB //SYSUDUMP DD SYSOUT=A //SARINDEX DD DISP=SHR,DSN=CAI.CVDEOPTN //PRT68 DD DISP=SHR,DSN=CAI.CVDEOPTN(PRINT68) //* //*PRT70 DD DISP=SHR,DSN=CAI.CVDEOPTN(PRININT70) //*OUTPUT70 DD DISP=(NEW,DELETE,DELETE), //* DCB=(LRECL=32756,BLKSIZE=32760,RECFM=VBM,DSORG=PS), //* SPACE=(CYL,(1,1)),UNIT=SYSDA //*INDEX70 DD DISP=(NEW,DELETE,DELETE), //* DCB=(LRECL=32756,BLKSIZE=32760,RECFM=VBM,DSORG=PS), //* SPACE=(CYL,(1,1)),UNIT=SYSDA //*RESOBJ70 DD DISP=(NEW,DELETE,DELETE), //* DCB=(LRECL=32756,BLKSIZE=32760,RECFM=VBM,DSORG=PS), //* SPACE=(CYL,(1,1)),UNIT=SYSDA //* //SARLOG DD SYSOUT=A
Note: A sample PROC is in CAI.CVDEPROC.
The following explains the statements in the example:
Defines that the CA View CAI.CVDELOAD and the ACIF load library (containing the APKACIF utility) must be in an authorized STEPLIB concatenation, or in a LNKLSTxx library.
If ACIF output is to be written to a CA Spool system, add your CA Spool load library to the STEPLIB concatenation.
Specifies the PDS members containing the ACIF control statements.
For information about coding these statements, see the chapter "Archival" in the Reference Guide.
Contains parameters for each CA View ACIF archive.
The ddname must match that of the corresponding JES2 PRINTER(nnnn) device, or JES3 JNAME value. Multiple PRTnnnn DD statements can be specified for each CA View ACIF archive.
If ACIF output is to be written to a CA Spool system, add your CA Spool load library to the STEPLIB concatenation.
Specifies that CA View ACIF messages are written to it. These messages are documented in the IBM manual, Advanced Function Presentation, Conversion and Indexing Facility Application Programming Guide.
Specifies temporary index dataset If ACIF output is to be written to a CA Spool system.
Specifies temporary output dataset If ACIF output is to be written to a CA Spool system.
Specifies temporary resource dataset If ACIF output is to be written to a CA Spool system.
CA View FSA device control statements are defined in the CA View ACIF FSS start procedure with PRTnnnn DD statements. Each PRTnnnn DD statement must have a JES device initialization parameter statement (see Step 1: Define JES2 Initialization Statements and Step 2: Define JES3 Initialization Statements earlier in this chapter).
Use the sample ACIF device control statements as a guide. Place these statements in a product PARMLIB or in SYS1.PARMLIB.
Information about the coding rules of the FSA Device Control Statements is documented in the IBM manual, Advanced Function Presentation, Conversion and Indexing Facility Application Programming Guide.
This example shows the CA View ACIF device control statements. Place these statements in a program product PARMLIB, or SYS1.PARMLIB.
TYPE=ACIF NAME=highlevelindex.view.database ARCHMSG=LOG NOGRPID= CHARS=(GT15,GS15,GU15,GU15) FDEFLIB=SYS1.FDEFLIB,USER.AFPLIB FONTLIB=SYS1.FONTLIBB,USER.AFPLIB FORMDEF=A10110 OVLYLIB=SYS1.OVERLIB,USER.AFPLIB PAGEDEF=V06683 PDEFLIB=SYS1.PDEFLIB,USER.AFPLIB PSEGLIB=SYS1.PSEGLIB,USER.AFPLIB NEWCLASS=T NEWDEST= NEWFORM= NEWPRMOD= NEWWTR= NEWESF=cccc COMBINE=NO INDEXDD= OUTPUTDD= RESOBJDD=
The following list describes the CA View ACIF device control statements:
Indicates that the FSA is identified as an ACIF archive.
Code TYPE=ACIF as the first statement.
Specifies the high-level name of the CA View database.
Specifies whether to issue a SARACI22 message every time that CA View archives a SYSOUT data set. LOG specifies that no WTO console messages are produced (only SARLOG messages are created, if SARLOG is present).
Specifies the action to be taken if the SARINDEX Library does not contain a member identified by the GROUPID= parameter on the //name OUTPUT JCL statement.
Issues the message SARACI06, and archive the Sysout with the default specifications.
Issues the message SARACI06, mark the report in CA View as 'ACIF' in the Exception Code Field, the SARACI06 with other APKACIF messages are stored in the CA View report, and the JES 'Release/Hold' command is executed against the Sysout.
Default: PROCESS.
Specifies up to four different default font names.
A font name must be from 1–4 alphanumeric or national characters.
Specifies up to eight form definition libraries.
Specifies up to eight font libraries.
Specifies the default form definition.
Specifies up to eight overlay libraries.
Specifies the default page definitions.
Specifies up to eight page definition libraries.
Specifies up to eight page-segment libraries.
Specifies the new SYSOUT CLASS under which to archive.
This class becomes the default SYSOUT CLASS for reprinting. It is not used for archival data created by CA Deliver or CA View systems extensions.
The value of this parameter, if specified, becomes the class value for the report in the CA View database. Reprint Class translation, as specified by the SARINIT parameter NEWCLSL, can still occur whether NEWCLASS is specified, if the report is not a CA Deliver report.
Specifies the new SYSOUT DEST under which to archive.
This DEST becomes the default SYSOUT DEST for reprinting. It is not used for archival data created by CA Deliver or CA View systems extensions.
The value of this parameter, if specified, becomes the destination value for the report in the CA View database. The SARINIT parameter NEWDEST, if specified, overrides this parameter when the report is reprinted.
Specifies the new SYSOUT FORM under which to archive.
This form becomes the default SYSOUT FORM for reprinting. It is not used for archival data created by CA Deliver or CA View systems extensions.
The value of this parameter, if specified, becomes the forms value for the report in the CA View database. The SARINIT parameter NEWFORM, if specified, overrides this parameter when the report is reprinted.
Specifies the new SYSOUT process mode under which to archive.
This mode becomes the default SYSOUT process mode for reprinting. It is not used for archival data created by CA Deliver or CA View systems extensions.
Specifies the new SYSOUT WRITER name under which to archive.
This name becomes the default SYSOUT WRITER name for reprinting. It is not used for archival data created by CA Deliver or CA View systems extensions.
Specifies the new CA Spool Subsystem Identifier (SUBID=) where the ACIF output is to be written.
This parameter specifies that the ACIF output should be written to the CA Spool system cccc instead of writing it to a CA View database. This allows further processing, such as printing, transferring to remote destinations, transforming to other document formats.
The NEWESF parameter is mutually exclusive with the NAME parameter.
Specifies if multiple ACIF outputs are to be combined into a single CA Spool file or not, when NEWESF is specified.
Do not combine sysout datasets. Each sysout is written as a unique CA Spool file.
This is the default value.
Combine sysout datasets with the same jobname, jobid and GROUPID to a single CA Spool file.
If the ACIF FSS collector is driven by a CA Spool printer definition, PSFOPT=7 must be specified.
Combine all sysout datasets produced by given job into a single CA Spool file.
If the ACIF FSS collector is driven by a CA Spool printer definition, PSFOPT=7 must be specified.
Note: PSF supports CA Spool files containing multiple ACIF outputs. The CA Spool AFP transformers generate warning messages when processing CA Spool files containing multiple ACIF outputs. The CA Spool Java transformers do not support CA Spool files containing multiple ACIF outputs.
Specifies DD-name for temporary index dataset. This parameter statement is required if NEWESF is specified.
Specifies DD -name for temporary output dataset. This parameter statement is required if NEWESF is specified.
Specifies DD -name for temporary resource dataset. This parameter statement is required if NEWESF is specified.
The following steps are required to install the CA View PDF Archiver. Each step is explained in detail in the following sections.
Note: For more information about archiving PDF reports to CA View, control statements and a complete example of the process, see the chapter "Archival" in the Reference Guide.
PDF indexing/archiver requires a functional subsystem definition (FSS).
Note: FSS printers can be installed under JES2, JES3, or CA Spool. If you are planning to use CA Spool to host the PDF FSS collector, see the CA Spool documentation for more information about how to install and operate FSS printers under CA Spool.
After you have defined the CA View FSS printer to CA Spool, Skip Steps 1 and 2 and continue with Step 3 in this section.
This product includes the zLib general purpose compression library. CA is grateful to the authors for making it available for inclusion in this software.
This step provides a sample FSS definition, JES2 initialization statements, and a JES2 print statement.
Use the sample FSS definition as a guide and place the JES2 initialization statements in the JES2 PARMLIB or in a SYS1.PARMLIB.
Note: For more information about JES2 statements and a description of all of the FSSDEF parameters, see the IBM JES2 Initialization and Tuning Reference for your operating system.
This example shows JES3 statements for a CA View PDF archiver.
Place these statements in SYS1.PARMLIB.
FSSDEF,TYPE=WTR,FSSNAME=FSSSAR,PNAME=PDFCOLCT
DEVICE,JNAME=PRT1,DTYPE=SARPDF,MODE=FSS,
PM=PDFC,WS=(PM),HEADER=NO
A sample PROC is in CAI.CVDEPROC.
The FSSDEF initialization statement defines an FSS to JES2.The following explains the JES2 initialization statements used in the definition of a CA View PDF archiver. The syntax is as follows:
FSSDEF Statement
The FSSDEF statement is associated with one or more PRTnnnn statements that define each archiver FSA. The FSSDEF initialization parameter is optional, but recommended. If it is omitted, JES2 generates a default for that archiver.
The FSSDEF statement contains the following parameters:
Defines the unique 1- to 8-character name of an FSS,
When you start the first CA View PDF archiver that has an FSA definition for that FSS, an FSS address space is created for the archiver. The CA View PDF interface manages this FSS and the archival FSA for the first CA View PDF archiver. If you start a second archiver with an FSA definition for the same FSS, the CA View PDF interface manages a separate FSA for the second archival FSA in that FSS.
Under JES2, each FSS can support a maximum of 24 FSAs. The actual number of FSAs per FSS depends on several factors, such as the size of resources used in the print jobs and the available virtual storage.
This parameter is required.
Defines a procedure for starting the CA View PDF FSS.
The procedure (which must be defined before this FSS is started) is a member of either SYS1.PROCLIB or a library concatenated to SYS1.PROCLIB. Different FSSDEF initialization parameters can refer to the same startup procedure.
Defines the 1- to 8-character name of the load module that is loaded into the PSF FSS address space.
This load module contains the various JES2-supplied FSI service routines. For CA View PDF, specify the default value (HASPFSSM = HASPFSSM).
A PRINTER(nnnn) statement (required to define each FSA) is associated with an FSSDEF statement. Each archival FSA should have a unique PRINTER(nnnn) name. This unique PRINTER(nnnn) must match the label on the device parameter DD statement in the procedure for starting the CA View PDF FSS.
PRINTER(nnnn)
The PRINTER(nnnn) parameters define JES2 default values. The PRINTER(nnnn) statement contains the following parameters:
Defines the output class used for selecting data sets to be archived.
This parameter is only needed when Q is specified as the work selection (WS) criterion.
One of the following:
Specifies that the archiver can be started by operator command.
Specifies that the archiver is started automatically when JES2 begins processing.
Defines the FSS for the archiver.
This value must match the value coded for an FSSNAME parameter for the corresponding FSSDEF statement. This parameter is required.
Indicates that the printer is managed by an FSS (MODE=FSS).
This parameter is required.
Defines the processing mode used for selecting data sets to be archived.
This parameter is only needed when PRM is specified as the work selection (WS) criterion.
Specifies that no separator pages are produced.
Specifies that track-cell de-spooling is used with this printer.
Defines the route code used for selecting data sets to be archived.
This parameter is only needed when R is specified as the work selection (WS) criterion.
Defines the form identifier used for selecting data sets for archival.
This parameter is only needed when F is specified as the work selection (WS) criterion.
Defines the writer name used for selecting data sets for archival.
This parameter is only needed when W is specified as the work selection (WS) criterion.
Defines the work selection criteria for archival.
Examples of WS are:
Selects all data sets having a process mode of PDF.
Selects all data sets having a SYSOUT class of S.
This step provides a sample FSS definition, JES3 initialization statements, and a JES3 device statement.
Use the sample FSS definition as a guide and place the JES3 initialization statements in a SYS1.PARMLIB.
Note: For more information about JES3 statements, see the IBM JES3 Initialization and Tuning Reference for your operating system.
This example shows JES3 statements for a CA View PDF archiver.
Place these statements in SYS1.PARMLIB.
FSSDEF,TYPE=WTR,FSSNAME=FSSSAR,PNAME=PDFCOLCT
DEVICE,JNAME=PRT1,DTYPE=SARPDF,MODE=FSS,
PM=PDFC,WS=(PM),HEADER=NO
A sample PROC is in CAI.CVDEPROC.
The FSSDEF initialization parameter defines an FSS to JES3. The following explains the JES3 initialization statements used in the definition of the CA View PDF archivers. The syntax is as follows:
FSSDEF Statement
The FSSDEF initialization statement is optional, but recommended. If it is omitted, JES3 generates a default for that archiver. The FSSDEF statement can contain the following parameters:
Specifies that the FSS is an output writer for deferred printing (TYPE=WTR).
This parameter is required.
The unique 1- to 8-character name of an FSS.
This parameter is required.
A procedure for starting a specific CA View PDF FSS.
The procedure (which must be defined before that FSS is started) is a member of the procedure library defined by the STCPROC parameter of the STANDARDS statement, or of the IATPLBST procedure library (the default). Different FSSDEF initialization parameters can refer to the same startup procedure.
The JES3 processor on which the FSS runs.
The name must be the same as specified on the NAME parameter of the MAINPROC statement for the processor.
YES specifies that the FSS is terminated if the JES3 global address space terminates by a *RETURN or *DUMP operator command.
A DEVICE statement is required for each archival FSA. The DEVICE parameters create JES3 default values that are used unless other values are specified in the JCL application program. The DEVICE statement can contain the following parameters:
Defines a parameter that is ignored by CA View PDF, but must be specified.
Any name can be used.
Specifies a unique FSS for this CA View PDF archiver DEVICE statement.
The value must match the value coded for the FSSNAME parameter in the corresponding FSSDEF statement. This parameter is required.
Indicates that no data set header pages are printed.
Specifies the 1- to 8-character name of the CA View PDF archiver FSA.
Each archiver FSA must have a unique JNAME. This JNAME must correspond to the name on the DEVICE DD statement in the procedure for starting the CA View PDS FSS. This parameter is required.
Specifies the JUNIT = (,,,OFF) for CA View PDF archival.
Indicates that the archiver is managed by an FSS.
This parameter is required.
The work selection criteria.
The options are:
Specifies selection by SYSOUT class.
Specifies selection by process mode.
This PROC specifies initialization parameters and libraries that contain system and installation resources for the CA View PDF archiver.
Before starting a CA View PDF archiver, ensure you have a cataloged startup PROC in SYS1.PROCLIB or a procedure library concatenated to it. Use the sample JCL for CA View PDF startup procedure in the next section as a guide.
//PDFCOLCT PROC //PDFCOLCT EXEC PGM=SARFSS,TIME=1440, // REGION=2M //STEPLIB DD DSN=CAI.CVDELOAD,DISP=SHR //SYSUDUMP DD SYSOUT=A //PDFINDEX DD DSN=VIEW.PDFINDEX,DISP=SHR //PRT11 DD DSN=CAI.CVDEOPTN(PRT11),DISP=SHR //SARLOG DD SYSOUT=A //PDFREPRT DD SYSOUT=X <---- DEFAULT PDF REPORT DATASET //PDFTRACE DD SYSOUT=X <---- DEFAULT PDF TRACE REPORT DATASET //SARLOG DD SYSOUT=X <---- DEFAULT SARLOG OUTPUT. //SYSOUT DD SYSOUT=X <-- - Informationary messages from PDF DEFLATE. //STDERR DD SYSOUT=X // PEND //VIEWPDF EXEC PROC=PDFCOLCT
Note: A sample PROC is in CAI.CVDEPROC.
The following explains the statements in the example:
Defines the CA View CAI.CVDELOAD must be in an authorized STEPLIB concatenation, or in a LNKLSTxx library.
Specifies the PDS members containing the PDF control statements.
For information about coding these statements, see the chapter "Archival" in the Reference Guide.
Contains parameters for each CA View PDF archive.
The ddname must match that of the corresponding JES2 PRINTER(nnnn) device, or JES3 JNAME value. Multiple PRTnnnn DD statements can be specified for each CA View PDF archive.
Specifies that CA View PDF messages are written to it. These messages are documented in the Message Guide. The SARLOG DD statement is optional.
CA View FSA device control statements are defined in the CA View PDF FSS start procedure with PRTnnnn DD statements. Each PRTnnnn DD statement must have a JES device initialization parameter statement (see Step 1: Define JES2 Initialization Statements and Step 2: Define JES3 Initialization Statements earlier in this chapter).
Use the sample PDF device control statements as a guide. Place these statements in a product PARMLIB or in SYS1.PARMLIB.
For more information about the coding rules of the FSA device control statements, see the IBM manual, Advanced Function Presentation, Conversion and Indexing Facility Application Programming Guide.
TYPE=PDF ARCHMSG=LOG NAME=CA VIEW.SAR.DATABASE.TO.RECIEVE.INTO
The following list describes the CA View PDF device control statements:
Indicates that the FSA is identified as a PDF archive.
Code TYPE=PDF as the first statement.
Specifies the high-level name of the CA View database.
Specifies whether to issue a CAHPDF01I message every time that CA View archives a SYSOUT data set. LOG specifies that no WTO console messages are produced (only SARLOG messages are created, if SARLOG is present).
Specifies the new SYSOUT CLASS under which to archive.
This class becomes the default SYSOUT CLASS for reprinting. It is not used for archival data created by CA Deliver or CA View systems extensions.
The value of this parameter, if specified, becomes the class value for the report in the CA View database. Reprint Class translation, as specified by the SARINIT parameter NEWCLSL, can still occur whether NEWCLASS is specified, if the report is not a CA Deliver report.
Specifies the new SYSOUT DEST under which to archive.
This DEST becomes the default SYSOUT DEST for reprinting. It is not used for archival data created by CA Deliver or CA View systems extensions.
The value of this parameter, if specified, becomes the destination value for the report in the CA View database. The SARINIT parameter NEWDEST, if specified, overrides this parameter when the report is reprinted.
Specifies the new SYSOUT FORM under which to archive.
This form becomes the default SYSOUT FORM for reprinting. It is not used for archival data created by CA Deliver or CA View systems extensions.
The value of this parameter, if specified, becomes the forms value for the report in the CA View database. The SARINIT parameter NEWFORM, if specified, overrides this parameter when the report is reprinted.
Specifies the new SYSOUT process mode under which to archive.
This mode becomes the default SYSOUT process mode for reprinting. It is not used for archival data created by CA Deliver or CA View systems extensions.
Specifies the new SYSOUT WRITER name under which to archive.
This name becomes the default SYSOUT WRITER name for reprinting. It is not used for archival data created by CA Deliver or CA View systems extensions.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|