Archive AFP Reports

You can archive AFP reports with a CA View ACIF (AFP Conversion and Indexing Facility) archiver. An ACIF archiver is a functional subsystem application (FSA) that runs under a separate address space called a Functional Subsystem (FSS). A Functional Subsystem Interface (FSI) maintains communication between the FSS and the JES global address space. AFP Conversion and Indexing Facility (ACIF) is a utility that is part of the IBM PSF/MVS product.
view
You can archive AFP reports with a CA View ACIF (AFP Conversion and Indexing Facility) archiver. An ACIF archiver is a functional subsystem application (FSA) that runs under a separate address space called a Functional Subsystem (FSS). A Functional Subsystem Interface (FSI) maintains communication between the FSS and the JES global address space. AFP Conversion and Indexing Facility (ACIF) is a utility that is part of the IBM PSF/MVS product.
For CA Deliver clients, AFP data
cannot
be archived using CA Deliver direct to CA View archival. It must be archived to JES.
For spool datasets that are encrypted with JES2 Spool encryption, the SARFSS collector task requires read access to the encryption keys. Without read access to the encryption keys, the respective datasets are not collected.
Contents
Starting and Stopping ACIF Archival
Under JES2, an ACIF archiver FSA can be started in one of the following ways:
  • An operator can enter the START DEVICE JES2 command
  • When JES2 is brought up, ACIF archival starts automatically if the PRT
    nnnn
    statement for the printer FSA contains the START parameter
Under JES3, an ACIF archiver FSA can be started in one of the following ways:
  • An operator can enter the START WRITER JES3 command
  • JES 3 starts the ACIF archival when printing is scheduled for a printer FSA
If you do not want archival to stop after each job, you can define the FSS as a JES3 "hot writer," keeping the address space active.
The ACIF archival FSA differs from normal printers in that it can only be started and stopped. Positioning commands, such as those to interrupt a printer, forward space, or backspace the printer, cannot be used.
Viewing AFP Reports
The following options are available to view AFP reports through the online system:
  • View the text portions of the report on a 3270 terminal, by selecting the report.
  • Use Web Viewer to view the report in PDF format, see CA Spool Java Transformers in the Web Viewer documentation.
Indexing AFP Reports
For each SYSOUT data set to be processed by a CA View ACIF archiver, a set of control statements can be used to define indexing criteria and provide other attributes for archival.
These control statements are created as members of the SARINDEX PDS, specified in the CA View ACIF start procedure. The name of the member is coded on the GROUPID parameter of the //OUTPUT JCL statement for the SYSOUT data set. If the GROUPID parameter is not coded, the name of the member defaults to the job name. For reports routed from CA Deliver, the GROUPID field can be defined in the CA Deliver Report Definition Attribute screen.
IBM ACIF Control Statements
The following IBM ACIF control statements can be coded for a CA View ACIF archiver:
CPGID FIELD
n
GROUPNAME IMAGEOUT (default changed to ASIS) INDEX
n
RESTYPE (default changed to ALL) TRIGGER
n
INDEXOBJ (default changed to ALL)
ACIF Control Statements
In addition to the IBM ACIF control statements, you can code the following CA View ACIF archival control statements:
DOWNLOAD=
DOWNLOAD specifies up to 256 user IDs to which the archived SYSOUT is queued for downloading to CA Output Management Document Viewer.
REPORTID=
REPORTID specifies a 1- to 32-character name under which the report is to be archived. If omitted, the job name is used, except for CA Deliver, which uses the CA Deliver report identifier.
Note:
The report-id is entered exactly as desired after the REPORTID keyword and can contain spaces or any supported special characters. If the report-id has more than 32-characters, it is truncated at 32-characters.
USERDATA=
USERDATA specifies storage of 1 to 20 bytes of user data in the GCRUSER field.
AFP Report Archival Example
The following example describes implementing the CA View ACIF archival interface to archive an AFP report.
Suppose you have defined a CA View ACIF archiver to JES2 as device PRT18. JES2 is to select any data set for this archiver with a processing mode of ACIF. The name of the start procedure is SARFSS.
JES2 Control Statements
The following JES2 control statements are coded for this example:
FSSDEF(FSSSAR) PROC=SARFSS PRT18 FSS=FSSSAR, MODE=FSS, NOSEP, NOSEPDS, PRMODE=(ACIF), WS=(PRM)
Start Procedure for SARFSS
The start procedure for SARFSS is as follows:
//SARFSS PROC //SARFSS EXEC PGM=SARFSS,TIME=1440, // REGION=2M //STEPLIB DD DSN=CAI.CVDELOAD,DISP=SHR // DD DSN=ACIF.LOAD,DISP=SHR //SYSUDUMP DD SYSOUT=A //SARINDEX DD DSN=VIEW.SARINDEX,DISP=SHR //PRT18 DD DSN=CAI.CVDEOPTN(PRT18),DISP=SHR //SARLOG DD SYSOUT=A
Device Control Statements for PRT DD Statement
The following are the JES2 device control statements for PRT18 of our example:
TYPE=ACIF ARCHMSG=YES CHARS=(GT15,GX15) FDEFLIB=SYS1.FDEFLIB FONTLIB=SYS1.FONTLIB, SYS1.FONTLIBB, GSF.USERFONT PDEFLIB=SYS1.PDEFLIB OVLYLIB=SYS1.OVERLIB PSEGLIB=SYS1.PSEGLIB FORMDEF=A10110 PAGEDEF=V06683 NEWPRMOD=PAGE
Sample Application Job
The following sample application job generates SYSOUT to be indexed by CA View ACIF, and archived:
//SAMPJOB JOB ACCOUNT,PROGRAMMER //O1 OUTPUT GROUPID=S10056,PRMODE=ACIF, // PAGEDEF=A18D,FORMDEF=A18D1, // USERLIB=SAMPLE.USERLIB //STEP1 EXEC PGM=MYAPPL //REPORT DD SYSOUT=A,OUTPUT=*.O1, // DCB=(RECFM=FA,BLKSIZE=133)
The application MYAPPL generates the following report:
VWZ--Sample Application Job
ACIF Control Statements
The following ACIF control statements are in member S10056 of the SARINDEX PDS.
TRIGGER1=*,1,'1' /*SELECT page group by skipping to channel 1 TRIGGER2=0,120,'PAGE 1' /* and text string 1 FIELD1=2,9,24 /* Data field containing customer name FIELD2=2,40,8 /* Data field containing account number FIELD3=0,16,10 /* Data field containing division name FIELD4='A10-' /* constant INDEX1='Customer name',FIELD1 INDEX2='Account Number',FIELD4, FIELD2 INDEX3='Division',FIELD3 REPORTID=PHONEBILLS DOWNLOAD=JOHNB, MARYK, JIMT
You must index reports appropriately to minimize the size of page groups because you can view AFP reports using CA Output Management Document Viewer. In this example, we used the characters "PAGE 1" as the TRIGGER to signify a new page group, then indexed on the CUSTOMER NAME and ACCOUNT NUMBER.