AUTOHMSG filter list parameters

DSN=dataSetName

Filters the data set name as contained in the message text. If the message text contains either DSN or DATA SET, the next word is interpreted as the data set name. If the message text does not contain a data set name, a no value is used.

HSM_ACTION=filterAction

Filters the ACTION specification from the ARC0734I message text. The action is also parsed from ARC1000I, ARC1001I, and any message that contains ACTION in the text. If the message text does not contain an ACTION value, a value of blank is used. The action can be up to 14 characters.

HSM_AGE=filterAge

Filters the age of the data set as contained in the ARC0734I message text or any message with AGE in the message text. If the message text does not contain an AGE keyword, a value of 0 is used. The value is a number from 0 to 9999.

HSM_BLOCKS=filterBlocks

Filters the number of blocks as contained in the ARC0734I message text. If the message text does not contain a number of blocks, a value of 0 is used. The value is a number from 0 to 999999.

HSM_FRVOL=fromVol

Filters the from volume (FRVOL value) in the ARC0734I message text. For other messages, a value of blank is used.

HSM_HOST=filterHostID

Filters the host ID of the DFSMShsm address space that issues the message. The host ID is always available. Host ID is a two-position value that is defined in DFSMShsm.

HSM_MSGID=filterARCMsg

Filters the ARC message number

HSM_RC=filterRetCode

Filters the return code indicated in the message text. If the message does not include a return code value, 0 is used. The value is a number from 0 to 9999.

HSM_REAS=filterReasCode

Filters the reason code indicated in the message. If the message does not include a reason code value, 0 is used. The reason code is a number from 0 to 9999.

HSM_STRING=’text’

Filters the contents of the message text. The message text begins immediately after the ARC message number. You can use an asterisk and slash to search the message text for any value.

Observe the following guidelines when filtering values that include blanks:

• You cannot use quotes with slashes or asterisks in the HSM_STRING value.

• You can use quotes around the HSM_STRING value when matching the entire message text that includes blanks.

• When searching for a subset of the message text that includes blanks, you must use a question mark (?) to allow substitution of any character for the blank position.

The following HSM_STRING examples would search the string for 'backup' anywhere in the message text:

HSM_STRING=*backup/

HSM_STRING=*backup*

The following HSM_STRING examples use a question mark (?) to search the string for 'daily backup' anywhere in the message text:

HSM_STRING=*daily?backup/

HSM_STRING=*daily?backup*

HSM_TOVOL=filterToVol

Filters the to volume (TOVOL value) in the ARC0734I message text. For other messages, a value of blank is used.

HSM_TRACKS=filterTracks

Filters the number of tracks as contained in the message text for ARC0734I. If the message text does not contain a number of tracks, a value of 0 is used. The value is a number from 0 to 99999.

VOL=filerVolMsg

Filters the volume as contained in the ARC0734I message text. This parameter is set to the FRVOL value from the message text (if that value exists). If the message text does not contain a volume, a value of blank is used.

MGMTCLAS=mgmtClas

Filters the management class (defined in the catalog) to which the data set is assigned

POOL=poolName

Filters the pool name that is determined by the last primary volume on which the data set existed

STORCLAS=storClas

Filters the storage class (defined in the catalog) to which the data set is assigned

STOGROUP=storGroup

or

STORGRP=storGroup

Filters storage group (defined in the catalog) to which the data set is assigned