IBM Open Class Detection Tool

Installation Instructions

Installing the MVS Version

1. Download the file 'iocchk.xmit' from this page to your workstation.

2. Logon to your z/OS ftp site and issue the following commands:

FTP ftp.server
quote site recfm=fb lrecl=80
binary
cd //userid (replace 'userid' with your TSO userid)
put iocchk.xmit iocxmit

3. Logon to the z/OS TSO system and issue the following command:

RECEIVE INDSN('userid.iocxmit')

4. When prompted by the message "INMR906A Enter restore parameters or 'DELETE' or 'END' +", respond with:

DA('userid.load')


This completes the installation of the MVS version of the IBM Open Class Detection Tool to your z/OS system.


Installing the USS Version

1. Download the compressed file 'iocchk.zip' from this page to your workstation.

2. On your workstation, unzip 'iocchk.zip' to extract the executable file 'iocchk'.

3. Logon to your z/OS USS ftp site and issue the following commands:

FTP ftp.server
binary
put iocchk
quit

4. Verify the file permission of 'iocchk'. Logon to your z/OS USS account, change to the directory containing the 'iocchk' executable (your home directory by default), and issue the following command:

chmod +x iocchk


This completes the installation of the USS version of the IBM Open Class Detection Tool to your z/OS USS account.


Usage instructions
Usage: iocchk options[...] file

Where options can be:
-a Detect any DLL references (including non-IOC DLLs)
-v Show version information

And where file can be any of the following:
- zFS executable file (for example, ./myexec)
- zFS directory containing executable files (for example, /home/mydir)
- MVS executable module (for example, "//'HLQ.MYPDS(member)'")
- MVS PDS containing executable modules (for example, "//'HLQ.MYPDS'")
- PDS wildcard members (for example, "//'HLQ.MYPDS(mem*)'")

If no options are specified, iocchk checks to see if the input file makes any references to IBM Open Class Library Application Support Class or Collection Class DLLs.


Return codes
If the input file makes any references to IOC DLLs:
- Return code is 1
- iocchk reports:
<file> (<IOC DLL name>)

If the input file makes no references to IOC DLLs:
- Return code is 0
- iocchk reports:
<file>

If the input file is a PDS directory or a zFS directory:
- Return code indicates the total number of files within the directory that make references to IOC DLLs
- iocchk reports, for each file, as described above.

Sample USS command for invoking IOCCHK on a PDS containing executable modules
iocchk -v "//'CEE.SCEERUN2'"

Sample USS command for invoking IOCCHK on a zFS executable module
iocchk -v /usr/lpp/cbclib/bin/isdcnvt

Sample JCL for invoking IOCCHK on a PDS member
Here is a sample JCL to run IOCCHK on //'CEE.SCREERUN2(CDAEQDPI)' with the -v option. Note that USERID needs to be replaced with your user ID, and LOCATION.OF.IOCCHK needs to be replaced with the dataset name where you have stored the IOCCHK utility.


//USERIDP JOB (XXXA,XXXX),'IOCCHK',CLASS=A,MSGCLASS=S,
// NOTIFY=&SYSUID,USER=&SYSUID,
// MSGLEVEL=(1,1)
/*JOBPARM T=1,L=80
//IOC EXEC PGM=IOCCHK,
// PARM=('/ -v //''CEE.SCEERUN2(CDAEQDPI)''')
//SYSPRINT DD SYSOUT=*
//SYSCPRT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//STEPLIB DD DSN=LOCATION.OF.IOCCHK,DISP=SHR

Sample JCL for invoking IOCCHK on a zFS directory with executable files
Here is a sample JCL to run IOCCHK on /usr/lpp/cbclib/bin with the -v option. Note that USERID needs to be replaced with your user ID, and LOCATION.OF.IOCCHK needs to be replaced with the dataset name where you have stored the IOCCHK utility.


//USERIDP JOB (XXXA,XXXX),'IOCCHK',CLASS=A,MSGCLASS=S,
// NOTIFY=&SYSUID,USER=&SYSUID,
// MSGLEVEL=(1,1)
/*JOBPARM T=1,L=80
//IOC EXEC PGM=IOCCHK,
// PARM=('/ -v /usr/lpp/cbclib/bin/')
//SYSPRINT DD SYSOUT=*
//SYSCPRT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//STEPLIB DD DSN=LOCATION.OF.IOCCHK,DISP=SHR


Terms and conditions
By downloading, installing, copying, accessing or using this software you agree to the terms and conditions outlined in the License Agreement. Please review the License Agreement and License Information documents available below prior to proceeding with the download or installation