General parameter defaults
The PARMLIB sample member HSCM00 contains the general parameter default values that affect Session Monitor listed in this section. Review each parameter’s default value to ensure it supports your environment. If you modify any of these parameters, refresh your HSCM PARMLIB member.
DEFAULT_USER_PROFILE
Description:The default user profile member in the site profile dataset.
Values:1 to 8 characters.
Default:@@@@DFLT
GLOBAL_CSI
Description: The name of the Global CSI Dataset for this installation.
Values:1 to 44 characters.
Default: COMPWARE.GLOBAL.CSI
Required:Yes.
GLOBAL_RECORD_CAPTURE_LU1
Description: Set this parameter to NO to ensure no Archive Recording of 3270 LU1 type data occurs. Set this parameter to YES to globally record 3270 LU1 type data. LU1 type data is usually print data going to the master printer.
Values: YES or NO.
Default:NO
GLOBAL_RECORD_LU2_SECURITY
Description:Session Monitor for 3270 can validate a user’s authority to update script and repository datasets when the user creates, updates, or restarts an Archive Recording request. This parameter defines the types of datasets subject to this validation.
Set this parameter to:
- ALL to have Session Monitor for 3270 ensure the user has authority to update all datasets specified in the 3270/LU0 Archive Recording Request.
- SCRIPT to have Session Monitor for 3270 ensure the user has authority to update the script dataset specified in the 3270/LU0 Archive Recording Request.
- REPOS to have Session Monitor for 3270 ensure the user has authority to update the repository dataset specified in the 3270/LU0 Archive Recording Request.
- NONE if you do not need Session Monitor for 3270 to validate update authority.
Values:ALL, SCRIPT, REPOS, or NONE.
Default:NONE
GLOBAL_RECORD_REQUEST_FILE
Description:Name of the Archive Recording request file.
Values:1 to 44 characters.
Default:COMPWARE.QQFnnn.GRREQ
Required:Yes.
GLOBAL_RECORD_MQ_SECURITY
Description:Session Monitor for WebSphere MQ can validate a user’s authority to update script and repository datasets when the user creates, updates, or restarts an Archive Recording request. This parameter defines the types of datasets subject to this validation.
Set this parameter to:
- ALL to have Session Monitor for WebSphere MQ ensure the user has authority to update all datasets specified in the Archive Recording Request.
- REPOS to have Session Monitor for WebSphere MQ ensure the user has authority to update the repository dataset specified in the Archive Recording Request.
- NONE if you do not need Session Monitor for WebSphere MQ to validate update authority.
Values:ALL, REPOS, or NONE
Default:NONE
GLOBAL_RECORD_TCP_SECURITY
Description:Session Monitor for TCP/IP can validate a user’s update authority for script and repository datasets when the user creates, updates, or restarts a TCP/IP Archive Recording request. This parameter defines the types of datasets subject to this validation.
Set this parameter to:
- ALL to have Session Monitor for TCP/IP ensure the user has authority to update all datasets specified in the TCP/IP Archive Recording Request.
- REPOS to have Session Monitorfor TCP/IP ensure the user has authority to update the repository dataset specified in the TCP/IP Archive Recording Request.
- NONE if you do not need Session Monitor for TCP/IP to validate update authority.
Values:ALL, REPOS, or NONE
Default:NONE
PRODUCT_LOADLIB
Description:The Session Monitor load library dataset name.
Values:1 to 44 characters.
Default:COMPWARE.QQFnnn.SQQFLOAD
Required:Yes.
PRODUCT_PANELS
Description:The Session Monitor panel library dataset name.
Values:1 to 44 characters.
Default:COMPWARE.QQFnnn.SQQFPENU
PRODUCT_PROFILE
Description:The site user profile dataset name.
Values:1 to 44 characters.
Default:COMPWARE.QQFnnn.SITE.FILE
Required:Yes.
PRODUCT_REXX_EXEC
Description:Name of the Session Monitor REXX dataset.
Values:1 to 44 characters.
Default:COMPWARE.QQFnnn.SQQFEXEC
Required:Yes.
PRODUCT_SAMPLES
Description:Name of the Session Monitor samples dataset.
Values:1 to 44 characters.
Default:COMPWARE.QQFnnn.SQQFSAMP
JES2_NODE_NAME
Description:The job class that applications need to write to when sending e-mail.
Values:One character.
Default:B
Required:Yes.
PRIMARY_OPTION_MENU_LANGUAGE
Description:Defines what language to use when displaying the Primary Option Menu. This parameter is used as a suffix to the module ETRM@xxx.
Values:1 to 3 characters.
Default:ENU
NO_EXPIRY_CLASS
Description:Designed to be an SMS management class for non-expiring datasets (for example, those datasets that should never be automatically deleted because of age). These “live forever” datasets would typically be defined with JCL DD parameters such as RETPD=9999 (Retention Period) or EXPDT=1999/999 (Expiry Date).
The NO_EXPIRY_CLASS value is used in the definition of the “zero” or .#0000000 dataset in an archive definition. The .#0000000 (seven zeros) is used to hold queued archive search requests and so should exist as long as the archive does, only being deleted when the user deletes the archive request via Archive Recording. Thus, the use of the non-expiring management class is used to ensure it can never be deleted due to age.
Values:1 to 8 characters.
Default:N/A
MAINFRAME_CODEPAGE
Description:The name of the codepage for the data on the mainframe. This parameter is utilized by both reporting and the GUI interface. The primary purpose of this parameter is to indicate the mainframe codepage for conversion of data between the mainframe and client.
Values:1 to 8 characters.
Default:IBM-1047
Required:Yes.
MAX_HIPERSPACE_FILES
Description:For the Session Monitor for 3270 component, this parameter specifies the maximum number of hiperspace memory files that SIEM data delivery and audit search programs are allowed to allocate. Any system limit to the number of dataspaces and hiperspaces established by z/OS (for example, JES2 exit IEFUSI) or other customer software, will remain in effect and will not be extended by this setting. This parameter is provided in case the installer wishes to further restrict Session Monitor for 3270 specific use of hiperspaces. Best performance for SIEM data delivery and audit search programs is achieved when this number is higher than the highest anticipated number of concurrent sessions in a given execution. If this number is too small, multiple passes of repository data by the program must be made to process all the sessions in the input. If setting this number too high has negligible impact on Session Monitor resource utilization as hiperspaces are only allocated as needed and reused when no longer needed.
Values:Number from 2 to 2147483647 and 1 to 10 numeric digits long.
Default:2000
SECURITY_CLASS_NAME
Description:Defines the external security product’s class name. If you do not change the default (NOSECURITY), Session Monitor does not set an external security class name, resulting in a lack of external security. See Session-Monitor-security for more information.
Values:1 to 8 alphanumeric characters. You can enclose the value in quotes.
Default:NOSECURITY
SECURITY_CLASS_ENTITY
Description:Session Monitor uses the SECURITY_CLASS_ENTITY value as the high-level qualifier for an entity name that represents an Session Monitor security entity. The system’s security package (such as RACF) uses the entity name to control and restrict access to Session Monitor functions. For example, HIPER.FN.TESTING, a fully qualified entity name, is used to determine if a user has the authority for Session Monitor testing. See Session-Monitor-security for more information.
Values:1 to 8 alphanumeric characters. You can enclose the value in quotes.
Default:HIPER
SMTP_PROGRAM
Description:The name of the external JES writer that processed SMTP. This is typically SMTP.
Values:1 to 8 characters.
Default:SMTP
Required:Yes.
SECURITY_VOLUME
Description:Defines the external security product’s volume serial number where the dataset rules reside. If your site cannot use the default (HIPERX) as the volume-serial number, change it to an acceptable volume-serial number.
Values:1 to 6 alphanumeric characters. You can enclose the value in quotes.
Default:HIPERX
SECURITY_WILDCARD_CHAR
Description:Defines the external security product wildcard coding character. For RACF and CA Top Secret, set to HYPHEN. For CA ACF2, set to ASTERISK.
Values:HYPHEN or ASTERISK.
Default:HYPHEN
TARGET_ZONE
Description:Name of the Session Monitor SMP/E target zone for this installation.
Values:1 to 8 characters.
Default:QQFnnnT
Required:Yes.
VTCSMAIL_REGION_SIZE
Description:The size in megabytes to use on the REGION parameter in JCL produced executing program VTCSMAIL (E-mail Notification).
Values:Number from 0 to 9999 and 1 to 4 numeric digits long.
Default:0
VTCSSRCH_REGION_SIZE
Description:The size in megabytes to use on the REGION parameter in JCL produced executing program VTCSSRCH (Archive Search and SIEM).
Values:Number from 0 to 9999 and 1 to 4 numeric digits long.
Default:0
VTCSSCLN_REGION_SIZE
Description:The size in megabytes to use on the REGION parameter in JCL produced executing program VTCSSCLN (Search Failure Cleanup).
Values:Number from 0 to 9999 and 1 to 4 numeric digits long.
Default:0
QQFDELET_REGION_SIZE
Description:The size in megabytes to use on the REGION parameter in JCL produced executing program QQFDELET (Archive Delete w/Segments).
Values:Number from 0 to 9999 and 1 to 4 numeric digits long.
Default:0
SUPPRESS_UNKNOWN_AID_COUNT
Description:The value specified limits the number of times the ETRMTSOI: UNKNOWN AID DETECTED message is written to the console during script creation.
Values:Number from 0 to 1073741824 and 1 to 10 numeric digits long.
Default:1000000
For information about allocation parameters, see Allocation-parameter-defaults.