Installing CA Disk Message Check

Message Check Utility › Installing CA Disk Message Check

Installing CA Disk Message Check

To install the CA Disk message check perform the following procedure.

To install the CA Disk message check

Create a PDS that is used to hold user defined tables (for JOBNAME's, message number/word/string's). The PDS can be RECFM=FB and LRECL=80 with 1 directory block. You need update access to maintain the tables. See Step 7.
Define up to 4 GDG base entries for a consolidation run. Use LIMIT (255) for each of them. For example:
```
DEFINE GENERATIONDATAGROUP -
NAME(CA DISK.MSGCHECK.CONSOLID.GDG.ONE) -
LIMIT(255))
```
Insert the call (shown in the following) to the application into an ISPF selection panel. The panel can be your primary ISPF panel.
```
11,'CMD(%SMSPC) NEWAPPL(SMSP)'
```
The corresponding text may look like option 11 in the following list of ISPF Options:

ISPF Option	Primary	Option Menu
0	Settings	Terminal and user parameters
1	View	Display source data or listings
2	Edit	Create or change source data
3	Utilities	Perform utility functions
4	Foreground	Interactive language processing
5	Batch	Submit job for language processing
6	Command	Enter TSO or Workstation commands
7	Dialog Test	Perform dialog testing
8	LM Facility	Library administrator functions
9	IBM Products	IBM program development products
10	SCLM	SW Configuration Library Manager
11	SMSP	CA Disk Message Check
IP	IPCS	IPCS Problem Analysis Services
S	SDSF	System display and Search Facility
R	BookMgr/Read	IBM BookManager/Read MVS
TP	Third Party	Third Party Products
M	MVS	MVS Support Menu
N	Network	Network Product & Support Menu
D	Database	Database Product & Support Menu

Enter X to Terminate using log/list defaults.

Initialize the global environment of the application by entering the following command through the dialog:

Service. (ISPF 7.6)
SELECT CMD(%SMSPCOK) NEWAPPL(SMSP)

For example:

------- CA Disk Message Check Application Enter required field -------

Command ===>

CA Disk Message Log Output (DSN Prefix will be appended with Jobname)

data set Prefix ===>

DASD Unit ===> can be sysallda

CA Disk Load Library - specify only the default here

data set Name ===>

Check Jobs/Steps with DD-Stmt. SYS$EXIT only? ===> (Y/N Yes/No=all Jobs)

Print Summary Lines from CA-Disk? ===> (Y/N Yes/No)

Propagate CA-Disk Messages to CA-Vantage? ===> (0, 1 or 2)

0 = No, 1 = only recognized Error Messages, 2 = all checked Messages

Library Name ===>

for the Tables for this application - Tables are generated automatically.

(if you want to change this DSN please press HELP for instructions)

Press END KEY to save, Enter CANCEL command to cancel

Data set Prefix

The DSN prefix for all message data sets.

Check Jobs/Steps with DD-Stmt.

Indicating Yes performs the message check only if SYS$EXIT DD SYSOUT=* is in JCL.

Note: You still need to define JOBNAME table (see Step 9) to make this option become effective.

Print Summary Lines from CA-Disk

Indicating Yes includes report summary lines (for example: total data sets archived … ).

Library Name

The PDS name created in Step 1. Tables (members) with initial values are created.

These fields can be modified through the panel defined in Step 3.

Assemble/link the module SYSEXIT$.
Submit the member USERMODL in the INSTALLIB to activate the message check exit.
Ensure that the exit program VANSDM00 resides in the CCTULINK library if you want to propagate filtered messages to CA Vantage. Repeat this step if any CA Vantage PTF changes VANSDM00.
Note: For additional information, see the section Usermods – Exits to Other Products in the CA Vantage Reference Guide.
Selecting the option you defined in Step 3 gives you the following panel:
Note: Storage Management Experts should use this application.
```
--------------------- CA Disk Message Check Application --------------
```
```
Select Option ===>
```
```
0 Primary Options
```
```
1 Message Table Maintenance
```
```
2 Jobname Table Maintenance
```
```
3 Activation
```
```
X Exit
```
Option 0
Update fields by selecting this option. To change the PDS created in Step 1, you need to:
- Allocate a new PDS with the same attributes
- Copy members (tables with initial values created in Step 4) from the original PDS to the newly allocated PDS
- Update the library name (the last fields) in this panel
Option 1

To specify message number/word/strings for filtering process. See Step 8 for more details.

Option 2

To specify JOBNAME's for filtering process. See Step 9 for more details.

Option 3

To activate any update made in the previous 3 options.
To Insert or Update a CA Disk Message, select option 1 from the panel in the CA Disk Message Check Application screen to specify a message number, a specific word in message text, or a string in message text to identify messages you don't want to keep. You can add, delete, or change any entry in this table but make sure there is at least one entry in the table. The following is an example of inserting a new entry:
```
------------------ Insert or Update CA Disk Message ---------------------
```
```
Command ===>
```
```
Message Number      ===>    9999    4 Byte CA Disk Message Number
```
```
Check   ===>        W       S=String, W=Word, N=Normal (check only Number)
```
```
Offset or Counter   ===>    6       Position for "String" or nth "Word" in Message
```
```
String or Word      ===>    PDSE
```
```
Comment  ===>        Idle space release bypassing PDSE
```
```
 
```
```
Enter a CA Disk Message Number and additional check options above:
```
```
N: Check Message Number only (normal check)
```
```
Other checks:
```
```
S:  Check for a string starting on column n of the Message Text
```
```
    Allowed Range: 1 to 110 (Character 1 is the first character of the Text)
```
```
    The Message Number and leading blanks are not counted here.
```
```
W:  Check for a Word (counts all words in the Message Text and checks the
```
```
    The word with the given number)
```
```
    Allowed Range: 2 to 64 (word one has to be searched as a string)
```
```
        Press END KEY to terminate
```
To interpret the resulting message text:
```
ADSDM341 9999 DATA SET = DDD.SSS.NNN BYPASSED, PDSE DATA SET NOT COMPRESSED
```
9999 indicates the informational message issued by the PDS compress process. Specify W to check for a specific word, the word is the 6th word in message text (PDSE) Don’t count the module name - ADSDM341 and message number - 9999; any character(s) between two blanks is counted as a word), and the specific word to search is PDSE.

Brief comments are allowed to identify this particular message.

Note: We use 9999 as an example because CA Disk issues various 9999 messages and some of them are not informational but critical errors. For this same message, you may change the entry to check for a string such as 'DATA SET =' while setting the offset field to 1.

Words (a word string in a message text) or message numbers can be entered with N to identify a specific message. A 4-digit message number is required for each entry.

To Insert or Update a CA Disk Jobname or Jobname Prefix - Select option 2 from the panel in the CA Disk Message Check Application screen to specify generic or fully qualified JOBNAME's in this table. These identify which jobs are eligible for the message check process. You can add, delete, or change any entry in this table. At least one entry in the table is required. The following is an example of inserting a new entry:

------------Insert or Update Disk Jobname or Jobname Prefix -----------------

Command ===>

    Jobname or Prefix   ===> dsktest    (see below)

    Type                ===> p          (N=full qualified Jobname, P=Jobname

Prefix)

    Comment             ===>            CA Disk test jobs

    Include/Exclude     ===>            I (I=Include, E=Exclude this Job)

Enter a Jobname full qualified, Type is N )

Or a

Generic Jobname (which means you specify a prefix instead a full

qualified Jobname and Type must be P)

All Jobs which are excluded by these table entries are bypassed for all

Message checks ¦

Press END KEY to terminate

To validate a message check against all CA Disk jobs with JOBNAME DSKTEST* complete the following steps:

Enter the JOBNAME prefix in the Jobname or Prefix field (dsktest).
Enter P in the type field (dsktest is the prefix, not full job name).
Enter I to include these job(s) in the message check process.

If you have specified Y for Check Jobs/Steps with DD-Stmt. SYS$EXIT only? ===> (Y/N Yes/No=all Jobs) in Step 2, the DD SYS$EXIT must be in every JCL of those jobs included for message checking.

To Update or Change the tables, select option 3 from the panel in the CA-Disk Message Check Application screen to activate the two tables you have updated in Step 8 (Insert or Update CA Disk Message)and Step 9 (Insert or Update CA Disk Jobname or Jobname Prefix) Clearing the first Job Card in this panel sets the entire JCL to defaults.

----------- JCL to activate the CA Disk Message and Jobname Tables ------

COMMAND ===>

JOB Statement Information:         (verify before proceeding)

    ===> //       ISPAAA1A JOB (ACCOUNT),'NAME'

    ===> //       NOTIFY=ISPSXC1,CLASS=A,

    ===> //       MSGLEVEL=(1,1),MSGCLASS=T,

    ===> //       COND=(0,LT)

    ===> //*

    ===> //*

    ===> //*

Press ENTER to proceed

Use END Command to exit

Change the JOB card and review the entire job stream. There are three steps in this job: assemble, link, and copy.

--------------- JCL to activate the CA Disk Message and Jobname Tables ----------

COMMAND ===>

EXEC/DD Statement Information (1 of 3) (verify before proceeding)

    ===> //ASSEMBLY EXEC PGM=ASMA90,PARM='NODECK,OBJECT,LIST'

    ===> //*

    ===> //SYSPRINT DD SYSOUT=*

    ===> //SYSLIB       DD DISP=SHR,DSN=SYS1.MACLIB

    ===> //SYSUT1       DD UNIT=SYSDA,SPACE=(CYL,(1,1))

    ===> //SYSLIN       DD UNIT=SYSDA,SPACE=(CYL,(1,1,1)),

    ===> //     DSN=&TEMP(SMSP$TAB),DISP=(,PASS),

    ===> //     DSORG=PO,BLKSIZE=3200

    ===> //*

            //SYSIN     DD *     (will be inserted here)

Press ENTER to proceed

Use END Command to exit

-------------- JCL to activate the CA-Disk Message and Jobname Tables -----------

COMMAND ===>

EXEC/DD Statement Information (2 of 3)   (verify before proceeding)

    ===> //BIND  EXEC PGM=IEWL,PARM='AC=1,LIST,LET,RENT'

    ===> //SYSPRINT       DD SYSOUT=*

    ===> //SYSUT1       DD UNIT=SYSDA,SPACE=(CYL,(1,1))

    ===> //SYSLMOD       DD DISP=(,PASS),DSN=&LOAD,

    ===> // SPACE=(CYL,(1,1,1)),DSORG=PS,RECFM=U,

    ===> // BLKSIZE=15476,UNIT=SYSDA

    ===> //SYSLIB       DD DISP=(OLD,DELETE),DSN=&TEMP(SMSP$TAB)

    ===> //SYSLIN       DD DDNAME=SYSIN

    ===> //*

//SYSIN DD * will be inserted here

        INCLUDE SYSLIB(HYPSMTAB)         will be inserted here

        NAME SYSEXTAB(R)        will be inserted here

/* will be inserted here

Press ENTER to proceed

Use END Command to exit

If you do not see the following copy step, clear the first JCL statement, press enter, and update the job card again.

//COPY EXEC PGM=IEBCOPY,PARM=REPLACE
//SYSPRINT DD SYSOUT=*
//SYSUT1 DD DISP=(OLD,DELETE),DSN=&LOAD
//SYSUT2 DD DISP=OLD,DSN= The.PDS.Created.In.Step1
//SYSUT3 DD UNIT=SYSDA,SPACE=(CYL,(1,1))
//SYSUT4 DD UNIT=SYSDA,SPACE=(CYL,(1,1))

Once you have all three steps in place, enter the SUB command and check zero return code of this job. The tables initialized in Step 1 will be replaced.