Check the return code after the job completes.
Possible return codes are listed following.
|
Return Code |
Description |
|
RC 0 |
Normal completion; all values were OK. |
|
RC 4 |
Process finished; values exceeding format directions have been adjusted. |
|
RC 8 |
Process finished with errors; error toleration limit was not exceeded. |
|
RC 12 |
Process was stopped by errors exceeding the toleration limit. |
You also can use job APCIJS34 to import IMS transaction execution information from SysView IMS History Log.
The JCL for job APCIJS34 is in the PMA.CNTL library in member APCIJS34.
Job APCIJS34 performs the following steps while importing the data.
|
Job Step |
Description |
|
Step 1 |
Extract SMF 255(34) from APCINF |
|
Step 2 |
Scope handling - verify data against defined In-/Exclusions |
|
Step 3 |
Sort 1 |
|
Step 4 |
IMS transaction information import phase 1 |
|
Step 5 |
Sort 2 |
|
Step 6 |
IMS transaction information import phase 2 |
|
Step 1 |
Convert user-provided input to the internal format |
Provide the SysView IMS transaction history log records in the form of SMF type 255 subtype 34 as a sequential file under DD statement APCINF.
Each file record must contain the IMS transaction information in the required format. (For a complete description of the format requirements, see Format Requirements for the IMS Transaction Information Interface.)
Other DD statement information is shown next.
|
DD statement |
Organization |
Format |
Record length |
Description |
|
APCINF |
PS |
VB |
VB 32760 |
input file with the SysView for IMS transaction log records |
|
APCOUTF |
PS |
VB |
3120 |
temporary output file, input for next step |
|
APCREP |
PS |
FB |
80 |
information messages |
|
APCEREP |
PS |
FB |
80 |
warning and error messages |
Extract the transaction execution information and convert it to internal format as shown next.
In the first step, the provided IMS transaction information is checked for data validation and converted to the required format for further processing.
Be sure to make the following changes:
//APCIAS34 EXEC PGM=APCIAS34 //STEPLIB DD DISP=SHR,DSN=CAMAT.PMA.CEETLOAD //APCINF DD DSN=SMF.INPUT.DATASET // DISP=SHR //APCOUTF DD DSN=&&APCIMS1, // DISP=(,PASS), // UNIT=SYSDA, // DCB=(RECFM=VB,LRECL=3120,BLKSIZE=27998), // SPACE=(CYL,(10,20)) //SYSABEND DD SYSOUT=* //*YSUDUMP DD SYSOUT=* //APCREP DD SYSOUT=*,DCB=(RECFM=FB,LRECL=80) //APCEREP DD SYSOUT=*,DCB=(RECFM=FB,LRECL=80) //*
In these steps, the input data is tested against the defined Scope (In-/Exclusions), the summary regions (if defined) are built up, and the data is stored in the database.
//******************************************************************** //* * //* ACTION: CHECK INPUT FOR SYSTEM/TRX IN/EXLUSIONS * //* * //******************************************************************** //APCIASDI EXEC PGM=APCIASDI,REGION=4M //STEPLIB DD DISP=SHR,DSN=CAMAT.PMA.CEETLOAD //APCINF DD DSN=&&APCIMS1, // DISP=(OLD,DELETE) //APCOUTF DD DSN=&&APCIMS2, // DISP=(,PASS), // UNIT=SYSDA, // DCB=(RECFM=VB,LRECL=3120,BLKSIZE=27998), // SPACE=(CYL,(10,20)) //SYSUDUMP DD SYSOUT=* //APCBEXC1 DD DISP=SHR,DSN=CAMAT.PMA.KSDSEXC //APCREP DD SYSOUT=*,DCB=(RECFM=FB,LRECL=80) //APCEREP DD SYSOUT=*,DCB=(RECFM=FB,LRECL=80) //* //******************************************************************** //* * //* ACTION: SORT EXTRACTED IMS INFORMATION * //* * //******************************************************************** //SORT01 EXEC PGM=SORT //SORTIN DD DSN=&&APCIMS2, // DISP=(OLD,DELETE) //SORTOUT DD DSN=&&APCIMS3, // DISP=(,PASS), // UNIT=SYSDA, // DCB=(RECFM=VB,LRECL=3120,BLKSIZE=27998), // SPACE=(CYL,(10,20)) //SYSOUT DD SYSOUT=* //SORTDIAG DD SYSOUT=* //SYSIN DD * SORT FIELDS=(5,8,CH,A,23,4,BI,A,13,9,CH,A,27,5,BI,A) /* //* //******************************************************************** //* * //* ACTION: PROCESS SORTED IMS RECORDS * //* * //******************************************************************** //APCCASSA EXEC PGM=APCCASSA,PARM='IMS' //STEPLIB DD DISP=SHR,DSN=CAMAT.PMA.CEETLOAD //APCPARAM DD DISP=SHR,DSN=CAMAT.PMA.PARMS //APC110I DD DSN=&&APCIMS3, // DISP=(OLD,DELETE) //APC110O DD DSN=&&APCIMS4, // DISP=(,PASS), // UNIT=SYSDA, // DCB=(RECFM=VB,LRECL=255,BLKSIZE=27998), // SPACE=(CYL,(10,20)) //APCCCST1 DD DISP=SHR,DSN=CAMAT.PMA.KSDSCST //APCCDIC1 DD DISP=SHR,DSN=CAMAT.PMA.KSDSDIC //SYSUDUMP DD SYSOUT=* //APCREP DD SYSOUT=* //APCEREP DD SYSOUT=*
//* //******************************************************************** //* * //* ACTION: SORT INTERIM IMS RECORDS * //* * //******************************************************************** //SORT02 EXEC PGM=SORT //SORTIN DD DSN=&&APCIMS4, // DISP=(OLD,DELETE) //SORTOUT DD DSN=&&APCIMS5, // DISP=(,PASS), // UNIT=SYSDA, // DCB=(RECFM=VB,LRECL=255,BLKSIZE=27998), // SPACE=(CYL,(10,20)) //SYSOUT DD SYSOUT=* //SORTDIAG DD SYSOUT=* //SYSIN DD * SORT FIELDS=(5,8,CH,A,21,4,BI,A,13,8,CH,A,25,2,BI,A) /* //* //******************************************************************** //* * //* ACTION: PROCESS SORTED SMF RECORDS * //* * //******************************************************************** //APCCASSB EXEC PGM=APCCASSB,PARM='IMS' //STEPLIB DD DISP=SHR,DSN=CAMAT.PMA.CEETLOAD //APCPARAM DD DISP=SHR,DSN=CAMAT.PMA.PARMS //APC110I DD DSN=&&APCIMS5, // DISP=(OLD,DELETE) //APCCCST1 DD DISP=SHR,DSN=CAMAT.PMA.KSDSCST //SYSUDUMP DD SYSOUT=* //APCREP DD SYSOUT=* //APCEREP DD SYSOUT=* //
Check the return code after the job completes.
Possible return codes are as follows:
|
Return Code |
Description |
|---|---|
|
RC 0 |
Normal completion; all values were OK. |
|
RC 4 |
Process finished; values exceeding format directions have been adjusted. |
|
RC 8 |
Process finished with errors; error toleration limit was not exceeded. |
|
RC 12 |
Process was stopped by errors exceeding the toleration limit. |
|
Copyright © 2012 CA Technologies.
All rights reserved.
|
|