AKDCMD00 keyword syntax and descriptions

These are the required and optional keywords for the AKDCMD00 member.

Required parameters

CLIST_DSN

Names of the product library or libraries containing CLIST/REXX members.
Default value None
Syntax CLIST_DSN=clist.dsn.name
Acceptable values Specify any valid data set name.
Example CLIST_DSN=AKD.SAKDCLST

CNTL_DSN

Name of the product library or libraries containing CNTL members.
Default value None
Syntax CNTL_DSN=sample.dsn.name
Acceptable values Specify any valid data set name.
Example CNTL_DSN=AKD.SAKDCNTL

MSGS_DSN

Name of the product library or libraries containing the message members.
Default value None
Syntax MSGS_DSN=messages.dsn.name
Acceptable values Specify any valid data set name.
Example MSGS_DSN=AKD.SAKDMSGS

OPFX

Operational prefix for the audit data set allocations.
Important: These data sets must not be allocated as extended physical sequential data sets. Use a proper high-level qualifier so that the ACS routine allocates these data sets as non-extended physical sequential.
Default value None
Syntax OPFX=hlq1.hlq2
Acceptable values Specify any valid high-level qualifier, 1-13 bytes.
Example OPFX=AKD.WORK

PLANS_DSN

Name of the product library or libraries containing PLANS members. This is the data set name which is created in job AKDPLANS in the SAKDJCL library.
Default value None
Syntax PLANS_DSN=plans.dsn.name
Acceptable values Specify any valid data set name.
Example PLANS_DSN=AKD.PLANS

PLIB_DSN

Name of the product library or libraries containing ISPF panels.
Default value None
Syntax PLIB_DSN=panels.dsn.name
Acceptable values Specify any valid data set name.
Example PLIB_DSN=AKD.SAKDPENU

PFX

The prefix that you want used for user work files.
Default value &SYSUID
Syntax PFX=user.id.prefix
Acceptable values Specify a 1– to 20–byte user prefix.
Example PFX=&SYSUID._PRDJOB
Note: If your site does not allow the use of a user ID high-level qualifier for data set names, you must remove the comment asterisk (*) for PFX and specify an appropriate value for this parameter.Advanced Audit for DFSMShsm uses this prefix to allocate the &PFX.AKD.CNTL and &PFX.AKD.PLANS data sets.

PPFX

Product library prefix. Name of the product library prefix.
Default value None
Syntax PPFX=hlq1.hlq2
Acceptable values Specify any valid high-level qualifier, 1-20 bytes.
Example PPFX=AKD103.AKD

AUD_LARGEPRI

The primary space for sort DD cards in audit jobs.
Default value 100
Syntax AUD_LARGEPRI=100
Acceptable values 1 to 99999 (The space type is always CYL)
Example AUD_LARGEPRI=100

AUD_LARGESEC

The secondary space for sort DD cards in audit jobs.
Default value 200
Syntax AUD_LARGESEC=200
Acceptable values 1 to 99999 (The space type is always CYL)
Example AUD_LARGESEC=200

AUD_MCDS

The data set name of the MCDS. If you are using a split CDS, this keyword specifies the data set name for the first split.
Default value NULLFILE
Syntax AUD_MCDS=HSM.MCDS1
Acceptable values Specify any valid data set name.
Example AUD_MCDS=HSM.MCDS1

AUD_MCDS2

The data set name of the MCDS. If you are using a split CDS, this keyword specifies the data set name for the second split.
Default value NULLFILE
Syntax AUD_MCDS2=HSM.MCDS2
Acceptable values Specify any valid data set name.
Example AUD_MCDS2=HSM.MCDS2

AUD_MCDS3

The data set name of the MCDS. If you are using a split CDS, this keyword specifies the data set name for the third split.
Default value NULLFILE
Syntax AUD_MCDS3=HSM.MCDS3
Acceptable values Specify any valid data set name.
Example AUD_MCDS3=HSM.MCDS3

AUD_MCDS4

The data set name of the MCDS. If you are using a split CDS, this keyword specifies the data set name for the fourth split.
Default value NULLFILE
Syntax AUD_MCDS4=HSM.MCDS4
Acceptable values Specify any valid data set name.
Example AUD_MCDS4=HSM.MCDS4

AUD_BCDS

The data set name of the BCDS. If you are using a split CDS, this keyword specifies the data set name for the first split.
Default value NULLFILE
Syntax AUD_BCDS=HSM.BCDS1
Acceptable values Specify any valid data set name.
Example AUD_BCDS=HSM.BCDS1

AUD_BCDS2

The data set name of the BCDS. If you are using a split CDS, this keyword specifies the data set name for the second split.
Default value NULLFILE
Syntax AUD_BCDS2=HSM.BCDS2
Acceptable values Specify any valid data set name.
Example AUD_BCDS2=HSM.BCDS2

AUD_BCDS3

The data set name of the BCDS. If you are using a split CDS, this keyword specifies the data set name for the third split.
Default value NULLFILE
Syntax AUD_BCDS3=HSM.BCDS3
Acceptable values Specify any valid data set name.
Example AUD_BCDS3=HSM.BCDS3

AUD_BCDS4

The data set name of the BCDS. If you are using a split CDS, this keyword specifies the data set name for the fourth split.
Default value NULLFILE
Syntax AUD_BCDS4=HSM.BCDS4
Acceptable values Specify any valid data set name.
Example AUD_BCDS4=HSM.BCDS4

AUD_OCDS

The data set name of the OCDS.
Default value NULLFILE
Syntax AUD_OCDS=HSM.OCDS
Acceptable values Specify any valid data set name.
Example AUD_OCDS=HSM.OCDS

Optional parameters

JOBCARD1

First line to be used when creating JCL.
Default value Not applicable
Syntax JOBCARD1='jobcard data'
Acceptable values 3-60 bytes of data delimited by single quote (') marks.
Example JOBCARD1='//AKDJOB JOB (Acct),"AKD job".'

JOBCARD2

Second line to be used when creating JCL.
Default value Not applicable
Syntax JOBCARD2='jobcard data'
Acceptable values 3-60 bytes of data delimited by single quote (') marks.
Example JOBCARD2='// MSGCLASS=A,CLASS=B,'

JOBCARD3

Third line to be used when creating JCL.
Default value Not applicable
Syntax JOBCARD3='jobcard data'
Acceptable values 3-60 bytes of data delimited by single quote (') marks.
Example JOBCARD3='// NOTIFY=&SYSUID'

JOBCARD4

Fourth line to be used when creating JCL.
Default value Not applicable
Syntax JOBCARD4='jobcard data'
Acceptable values 3-60 bytes of data delimited by single quote (') marks.
Example JOBCARD4='//*'

JOBCARD5

Fifth line to be used when creating JCL.
Default value Not applicable
Syntax JOBCARD5='jobcard data'
Acceptable values 3-60 bytes of data delimited by single quote (') marks.
Example JOBCARD5='//* '

HISTPRI

Primary Space for Global Summary History file (allocated in AKDJCUST customization REXX).

The space type used for allocation is CYL.

Default value 30
Syntax HISTPRI=n
Acceptable values Any integer in the range 1-99999
Example HISTPRI=30

HISTSEC

Secondary Space for Global Summary History file (allocated in AKDJCUST customization REXX).

The space type used for allocation is CYL.

Default value 10
Syntax HISTSEC=n
Acceptable values Any integer in the range 0-99999.
Example HISTSEC=10

SMF_NUMBER

Use the SMF_NUMBER parameter to specify the SMF number to be used for creating SMF records whenever DFSMShsm commands or data sets deletion requests are performed within the product. Assign to this keyword the value that specifies which SMF number you want used when these records are generated. Leave this keyword unset if you do not want SMF recording performed.
Note: The value specified should not match with SMF numbers used by HSM.
Example SMF_NUMBER=250
Default value None
Syntax SMF_NUMBER=n
Acceptable values Specify any integer in the rance 128-255

WORKDC

SMS data class name to be used for file allocations.
Default value None
Syntax WORKDC=dataclas
Acceptable values Any valid SMS data class, 1-8 bytes.
Example WORKDC=DC001

WORKMC

SMS management class name to be used for file allocations.
Default value None
Syntax WORKMC=mgmtclas
Acceptable values Any valid SMS management class, 1-8 bytes.
Example WORKMC=MC008

WORKPRI

Primary allocation amount to be used for file allocations.
Default value 100
Syntax WORKPRI=n
Acceptable values Any integer in the range 1-99999.
Example WORKPRI=50

WORKSEC

Secondary allocation amount to be used for file allocations.
Default value 100
Syntax WORKSEC=n
Acceptable values Any integer in the range 0-99999.
Example WORKSEC=10

WORKSC

SMS storage class name to be used for file allocations.
Default value None
Syntax WORKSC=storclas
Acceptable values Any valid SMS storage class, 1-8 bytes.
Example WORKSC=SC002

WORKUNIT

UNIT name to be used for file allocations.
Default value SYSALLDA
Syntax WORKUNIT=unitname
Acceptable values Any valid unit name, 1-8 bytes.
Example WORKUNIT=AKDUNIT

Audit JCL parameters

The following parameters, all of which begin with AUD_, are used during JCL creation or submission (or both) of audit jobs in the Administration area of the ISPF interface.

AUD_FIXCDS_LIMIT

Maximum number of FIXCDS T statements issued. FIXCDS T statements are used to rebuild the TTOC.
Default value 3000000
Syntax AUD_FIXCDS_LIMIT=n
Acceptable values 1-10000000.
Example AUD_FIXCDS_LIMIT = 3000000

AUD_PRI

Primary Space for audit jobs.
Default value 100
Syntax AUD_PRI=n
Acceptable values 1-99999 (The space type is defined by variable AUD_SPC).
Example AUD_PRI = 100

AUD_SEC

Secondary Space for audit jobs.
Default value 200
Syntax AUD_SEC=n
Acceptable values 0-99999 (The space type is defined by variable AUD_SPC).
Example AUD_SEC = 200

AUD_SPC

Type of space allocation for audit jobs.
Default value CYL
Syntax AUD_SPC=CYL|TRK|BLK
Acceptable values CYL, TRK, BLK.
Example AUD_SPC=CYL

AUD_SYSOUT

Type of sysout for audit jobs.
Default value *
Syntax AUD_SYSOUT=sysouttype
Acceptable values Any acceptable sysout type.
Example AUD_SYSOUT=*

AUD_UNIT

Unit type of space allocation for permanent data sets created by the audit jobs.
Default value SYSALLDA
Syntax AUD_UNIT=unittype
Acceptable values Any acceptable unit type.
Example AUD_UNIT=SYSALLDA

AUD_WORK_UNIT

Unit type of space allocation for temporary data sets created by the audit jobs.
Default value SYSALLDA
Syntax AUD_WORK_UNIT=unittype
Acceptable values Any acceptable unit type.
Example AUD_WORK_UNIT=SYSALLDA

AUD_TTOC_ALIAS

Specifying YES turns on TTOC contents verification in the AKDAUDAL, AKDAUDMD, or AKDAUDBD audit jobs. Audit counts all the valid records in the TTOC extraction and compares it to the original block count from the TTOC record.
Default value YES
Syntax AUD_TTOC_ALIAS=YES|NO
Acceptable values YES, NO
Example AUD_TTOC_ALIAS=YES

AUD_TAPE_VOL

The volser used to perform Audit Media Control analysis. Audit jobs AKDAUDFT and AKDAUDFL.
Default value XXXXXX
Syntax AUD_TAPE_VOL=volser
Acceptable values Any six-character tape volser.
Example AUD_TAPE_VOL=C10210

AUD_TAPE_UNIT

Tape Unit Type used to perform Audit Media Control analysis. Audit jobs AKDAUDFT and AKDAUDFL.
Default value 3590-1
Syntax AUD_TAPE_UNIT=unittype
Acceptable values Any acceptable tape unit type.
Example AUD_TAPE_UNIT=3590-1

AUD_TAPE_ANALYSIS

For a description of options see the section “Audit Procedures for DFSMShsm-Owned Tapes”. Audit jobs AKDAUDFT and AKDAUDFL.
Default value FAST
Syntax AUD_TAPE_ANALYSIS=FAST|THOROUGH|INTENSE
Acceptable values FAST, THOROUGH, INTENSE
Example AUD_TAPE_ANALYSIS=FAST

AUD_TTOC_DEVT

Device type used rebuilding records in the TTOC. Audit jobs AKDAUDFT and AKDAUDFD.
Default value 3590-1
Syntax AUD_TTOC_DEVT=tapedevicetype
Acceptable values Any acceptable tape device type.
Example AUD_TTOC_DEVT=3590-1

AUD_RMM_MSG

If you are using RMM as your Tape Manager, this is the data set name of the RMM Message Library. Audit job AKDAUDRM.
Default value RMM.SMS.MESSAGE
Syntax AUD_RMM_MSG=datasetname
Acceptable values Any valid data set name.
Example AUD_RMM_MSG=RMM.SMS.MESSAGE

AUD_RMM_RPT

If you are using RMM as your Tape Manager, this is the data set name of the RMM Report Library. Audit job AKDAUDRM.
Default value RMM.SMS.REPORT
Syntax AUD_RMM_RPT=datasetname
Acceptable values Any valid data set name.
Example AUD_RMM_MSG=RMM.SMS.REPORT

AUD_CA1_TMC

If you are using CA1 TMS as your Tape Manager, this is the data set name of the CA1 TMC Library. Audit job AKDAUDTP.
Default value TMS.TMC
Syntax AUD_CA1_TMC=datasetname
Acceptable values Any valid data set name.
Example AUD_CA1_TMC=TMS.TMC

AUD_TLMS_VMF

If you are using using TLMS as your Tape Manager, this is the data set name of the TLMS Volume Master File. Audit job AKDAUDHL.
Default value TLMS.VMF
Syntax AUD_TLMS_VMF=datasetname
Acceptable values Any valid data set name.
Example AUD_TLMS_VMF=TLMS.VMF

AUD_SMS_LIMIT

Limits the SMS audit job AKDAUDSM to the number of data sets on which to perform the ACS Management Class comparison. The default value for this parameter is 9999, due to the number of resources that must be allocated to perform the ACS testing. If you specify a larger number for this parameter, you should increase the values that you set for parameters AUD_PRI, AUD_SEC and AUD_SPC.
Default value 9999
Syntax AUD_SMS_LIMIT=n
Acceptable values Any integer in the range 1-99999.
Example AUD_SMS_LIMIT=999

AUD_SMS_CDS

The SCDS or ACDS data set name or the word ACTIVE. If you specify ACTIVE, the audit job uses the currently active ACS routine to test against.
Default value ACTIVE
Syntax AUD_SMS_CDS=ACTIVE|datasetname
Acceptable values ACTIVE or any valid SCDS/ACDS data set name.
Example AUD_SMS_CDS=SYS1.SMS.SCDS

AUD_SMS_DGTHLQ

The high-level qualifier of your installation's ISMF DGT libraries.
Default value SYS1
Syntax AUD_SMS_DGTHLQ=qualifier
Acceptable values Specify any qualifier from 1-8 bytes.
Example AUD_SMS_DGTHLQ=SYSX

AUD_SMS_ISPHLQ

The high-level qualifier of your installation's ISPF libraries.
Default value ISP
Syntax AUD_SMS_ISPHLQ=qualifier
Acceptable values Specify any qualifier from 1-8 bytes.
Example AUD_SMS_ISPHLQ=SYS1

COLLECT_HSM

Indicates whether you want DFSMShsm activity data collection performed.
Default value Yes
Syntax COLLECT_HSM=YES|Y|NO|N
Acceptable values YES, Y, NO, or N
Example COLLECT_HSM=YES

COLLECT_TIME

Advanced Audit for DFSMShsm stores the DFSMShsm activity data it collects in a common area before the data is written to the opfx.HSMACT data set (being allocated automatically). Use this parameter to specify the interval (in terms of seconds) in which this data is written to the data set.
Default value 3600 (1 hour)
Syntax COLLECT_TIME=n
Acceptable values Any integer in the range 10-86400.
Example COLLECT_TIME=7200
You may issue the COLLECT command with parameters to Advanced Audit for DFSMShsm through the MVS modify command in SDSF:
 /F AKDJMAIN,COLLECT FUNC=START/STOP

AUD_CLNDAYS

When datasets are recalled, D records are not deleted from the MCDS until (recall date + 3 + #days unreferenced until migration.) which can cause D records to be kept for many years. Thus, new audit is added to identify such MCD records and provide a provision to display or delete those. This parameter would be used to identify the MCDs for the datasets which have been recalled more than AUD_CLNDAYS days before current date.

Default Value 365
Syntax AUD_CLNDAYS=n
Acceptable values Any integer in the range 1-9999
Example AUD_CLNDAYS=730

Cost parameters

Initially, the cost parameters are taken from the AKDCMD00 member and can be overridden at the filtering panel of ERRSCOST report.

CPUCOST (CPU_COST alias is available)

A numeric parameter meaning cost of one CPU seconds, in cents.
Default value 25
Syntax CPUCOST=n
Acceptable values Any integer in the range 1-1000.
Example CPUCOST=25

TAPECOST (TAPE_COST alias is available)

The cost of one tape cartridge, in cents.
Default value 10000
Syntax TAPECOST=n
Acceptable values Any integer in the range 100-100000.
Example TAPECOST=10000