Previous Topic: Integrating ProductsNext Topic: Set Up CA ASM2 Integration


Set Up CA APCDOC Integration

Note: This step includes the fictitious CA APCDOC system name of SYSTEMS. You would use your own system name that is already defined to CA APCDOC.

  1. Access the CA APCDOC Main Menu (CASUGMSP), select Option 4 (Maintenance), and press enter.
  2. Enter 6 (DOCSCAN) on the Maintenance (Selection) panel (CASUMMSP), and press enter.
  3. On the Maintenance DOCSCAN (Selection) panel (CASUMNNP), select Option 2 to access the DOCSCAN Selection panel.
  4. On the Maintenance DOCSCAN (Selection) panel (CASUMNSP), enter all pertinent information for the system you intend to check with CA JCLCheck.

    CASUGMSP ---- CA APCDOC MAIN MENU - REL 1.3 ---------------- OPTION ===> 4 1 CROSS REF - Display Various Cross-References 2 DOCUMENTATION - Display and Update Documentation 3 REPORTS - Produce and View Reports 4 MAINTENANCE - Perform Database Maintenance Functions 5 SYSGEN - Update SYSGEN Information 6 CA JCLCHECK - Invoke CA JCLCHECK X EXIT - Terminate CA APCDOC Please Enter HELP for Helpful Information GENLEVEL for Genlevel Information

    CASUMMSP --------- MAINTENANCE (SELECTION) --------------------- OPTION ===> 6 1 DELETE - Delete Cross-Reference Records 2 UPLOAD - Upload the Documentation Database 3 DOWNLOAD - Download the Documentation Database 4 DBCOPY - Copy Documentation from One Database to Another 5 DOCPURGE - Purge Cross-Reference or Documentation Records in Batch 6 DOCSCAN - Invoke DOCSCAN to Update the Cross-Reference Database 7 DOCCHECK - Invoke DOCCHECK to Check the Cross-Reference Records

    -------- MAINTENANCE: DOCSCAN (SELECTION) --------------------- OPTION ===> 2 1 PROCLIB - Update Procedure Libraries 2 DOCSCAN - DOCSCAN Submission

    --------- MAINTENANCE: DOCSCAN (SELECTION) --------------------- COMMAND ===> Input Job Stream Joblist Name ==> (Enter * for a list) Liblist Name ==> (Enter * for a list) Data Set Name ==> 'CAI.CHQA.J670.CHQAJCL' Data Set Type ==> P (S=Seq | P=PDS | N=PANVALET | L=LIBRARIAN) Members to Include or Exclude ==> (I=Include | X=Exclude) ==> APCPROD1 ==> APCPROD2 ==> APCPROD3 Member Range From ==> To ==> SYSID ==> Processing Options: Reports to produce: VSAM Catalogs Used ==> Y (Y|N) DELTA ==> N (Y|N) Tape Pull ==> N (Y|N) VSAM Password ==> PRCDELTA ==> N (Y|N) Report==> N (Y|N) DIRUPD ==> N (Y|N) Job Action ==> N (Y|N) System Name ==> SYSTEMS APPEND Before ==> First ==> (Y) Predecessors ==> (Y|N) APPEND After ==> Last ==> (Y)

  5. Enter 0 on the CA JCLCheck/SPF Menu, press enter.
  6. Enter 1 on the CA JCLCheck Control Options Menu, press enter.
  7. Enter Y in the DICT field, and press F3 (End) to exit the panel.

    JCK0200-------------- CA JCLCHECK/SPF MENU ------------------------- OPTION ===> 0 Date: yyyy/mm/dd User: USERID1 Level: xx.x 0 - Option Specifications 1 - CA JCLCHECK - Foreground Invocation 2 - CA JCLCHECK - Foreground Invocation / Submit 3 - CA JCLCHECK - Batch Submit 4 - CA 7 Interface Invocation 5 - CA Scheduler Interface Invocation 6 - JCLNeat - Batch Submit 7 - RESOLVE - External Variable Resolution X - Exit

    ----------------- CA JCLCHECK/CONTROL OPTIONS MENU ------------------ OPTION ===> 1 Date: yyyy/mm/dd User: USER02 Time: 10:58 1 - Process Control Options 2 - Output Control Options 3 - Security Options 4 - JCLNeat Options 5 - Job Card Specifications X- Exit

      -----------CA JCLCHECK PROCESS CONTROL OPTIONS--------------------------   COMMAND ===>   Date: mm/dd/yyyy User: USER02 Time: 10:58         Go to ADDITIONAL PROCESSING OPTIONS PANEL   => N  CCLIST  - Number of program control cards to be listed  (0-999) => 5  COND    - Simulate execution according to condition codes => N  CTLSCAN - Scan utility control statements => Y  EASYPROC- CA Easyproclib support => N  MSS     - Stage VTOC of MSS volumes if necessary => N  PXREF   - Check program and PDS member existence => Y  SEV     - Minimum severity of errors to be listed (0-16) => 0  SPACE   - Check blksize efficiency for new DASD files => Y    (ALL) - Check blksize efficiency for existing DASD files too  => N    (NN)  - Minimum % of track usage (give warning if less) (0-99) => 65  SXREF   - Check JCL across jobs => N  VSAM    - Process private catalogs (JOBCAT, STEPCAT) => Y  PROC    - Define alternate proclibs => N          - Alternate proclib(s) are selected => N  DICT    - Define CA APCDOC XREF database => Y            Update PROFILE with these options                             => Y

  8. On the Define JCLCheck/APCDOC Data Base panel (JCK08), enter the name of the system in the SYSTEM field.
  9. Enter the CA APCDOC high-level qualifier in the CA APCDOC Database high-level qualifier field.
  10. Enter the CA APCDOC database name in the Database Name field.
  11. Enter the CA APCDOC database path in the Database Path field.

    Note: As an alternative, you can enter this information in the OPTIONS fields on the INVOCATION panel.

    Do not use the update parameter on the DICT option. CA JCLCheck obtains information about the predecessors from the database and uses it when scanning this job.

    Press F3 (End) to exit the panel.

    -----------------DEFINE JCLCHECK/APCDOC DATA BASE ----------------- JCK08 COMMAND ===> DATE - yyyy/mm/dd USER - USER02 TIME - 10:13 DICT - Production XREF Data Base Option UPDATE - Update the XREF Data Base from this run => N SYSTEM - System Name => SYSTEMS For CA APCDOC Release 1.1 and above, DBHLQ is required: APCDOC Database high level qualifier => 'CAI.CHQA' ------------------------------------------------------------------------- For CA APCDOC Release 1.0, database names are required: APCDOC Database Name => 'CAI.CHQA.CAAPCDOC.SYSDICT' APCDOC Database Path => 'CAI.CHQA.CAAPCDOC.SYSPATH' Important note: Enter either high level qualifer or database names, but not both.

  12. Return to the Foreground INVOCATION panel (JCK0201) and enter the data set name from your CA APCDOC panel in the Data Set Name field.
  13. Enter the library type in the Library Type field.
  14. Enter the member, with a job name in the middle of the system (SYSTEMS) (see number 8 in this group of steps), in the Member field, and press enter.

    The result is a list of predecessor/successor relationships for the jobs defined to that system.

    ---------------- CA JCLCHECK/INVOCATION ------------------------------ COMMAND ===> Option Selected: FOREGROUND Date: yyyy/mm/dd User: USER02 Time: 10:54 Data Set Name ===> 'CAI.APCMTL.CHQAJCL' Library Type ===> PDS (SEQ, PDS, PAN, LIB) Member ===> USER02 (Batch Submit -- Use * for all members) Volume Serial ===> (If Not CATALOGED) CPU-ID ===> (Multi-CPU Only, blank: This CPU) SYSTERM ===> N (Y/N/P, Error Statement and Messages only) SYSPRINT ===> Y (Y/N/P, Reports 1-9 according to options ) Specify any additional options (FOR THIS RUN ONLY) below OPTIONS ===> CC(5) CT SP(RPT 65 NOALL) V PROCX OPTIONS ===> J F XREF PXR(RPT) SX RP ER( END) OPTIONS ===> DICT SYN RUNT OPTIONS ===> SEC(DASD,STOR,MGMT,PROGRAM(DEFINE)) OPTIONS ===> SAVED ===> SAVED ===>

  15. You can update the CA APCDOC database from CA JCLCheck by specifying Y in the Update the XREF Data Base from this run field on the Define JCLCheck/APCDOC database panel (JCK08). This is great for stand‑alone jobs or when scanning an entire system.
  16. Enter the library type in the Library Type field.

    Note: For information about the DICT, SYSID, and SYSTEM runtime options, see the Command Reference Guide.

    ---------------DEFINE JCLCHECK/APCDOC DATA BASE ----------------- JCK08 COMMAND ===> DATE - yyyy/mm/dd USER - USERID TIME - 10:13 DICT - Production XREF Data Base Option UPDATE - Update the XREF Data Base from this run => Y SYSTEM - System Name => For CA APCDOC Release 1.1 and above, DBHLQ is required: APCDOC Database high level qualifier => CAI.CAAPCDOC ------------------------------------------------------------------------- For CA APCDOC Release 1.0, database names are required: APCDOC Database Name => APCDOC Database Path => Important note: Enter either high level qualifer or database names, but not both.

    -------------------- CA JCLCHECK/INVOCATION --------------------------- COMMAND ===> Option Selected: FOREGROUND Date: yyyy/mm/dd User: USER02 Time: 10:54 Data Set Name ===> 'CAI.APCMTL.CHQAJCL' Library Type ===> PDS (SEQ, PDS, PAN, LIB) Member ===> (Batch Submit -- Use * for all members) Volume Serial ===> (If Not CATALOGED) CPU-ID ===> (Multi-CPU Only, blank: This CPU) SYSTERM ===> N (Y/N/P, Error Statement and Messages only) SYSPRINT ===> Y (Y/N/P, Reports 1-9 according to options ) Specify any additional options (FOR THIS RUN ONLY) below OPTIONS ===> CC(5) CT SP(RPT 65 NOALL) V PROCX OPTIONS ===> J F XREF PXR(RPT) SX RP ER( END) OPTIONS ===> DICT(UP) SYN RUNT OPTIONS ===> SEC(DASD,STOR,MGMT,PROGRAM(DEFINE)) OPTIONS ===> SAVED ===> SAVED ===>