Job Monitor configuration file BLZJCNFG

Edit online

Modify the definitions in the BLZJCNFG configuration file to control Job Monitor actions.

Job Monitor provides JES-related services. You can control the Job Monitor actions with the definitions in BLZJCNFG.

Customize the sample Job Monitor configuration member hlq.SBLZSAMP(BLZJCNFG), like in the following sample. Comment lines start with a pound sign (#), when using a U.S. code page. Data lines can only have a directive and its assigned value. Comments are not allowed on the same line.

Note: The BLZJMON started task must be restarted to pick up any changes you make.
HOST_CODEPAGE=IBM-1047
SERV_PORT=6716
TZ=EST5EDT
#_BPXK_SETIBMOPT_TRANSPORT=TCPIP  
#APPLID=FEKAPPL                   
#AUTHMETHOD=SAF                   
#CODEPAGE=UTF-8                   
#CONCHAR=$                        
#CONSOLE_NAME=JMON                
#GEN_CONSOLE_NAME=OFF             
#HOST_CODEPAGE=IBM-1047           
#LIMIT_COMMANDS=USERID            
#LIMIT_CONSOLE=LIMITED            
#LIMIT_VIEW=NOLIMIT               
#LISTEN_QUEUE_LENGTH=5            
#LOOPBACK_ONLY=ON                 
#MAX_DATASETS=32                  
#MAX_THREADS=200                  
#TIMEOUT=3600                     
#TIMEOUT_INTERVAL=1200            
#TRACE_STORAGE=OFF                
#SEARCHALL=OFF                    
#SUBMIT_TIMEOUT=30                
#SUBMITMETHOD=TSO                 
#TSO_TEMPLATE=BLZ.SBLZSAMP(BLZTSO)
HOST_CODEPAGE
The host code page. The default is IBM-1047. Change to match your host code page.
SERV_PORT
The port number for Job Monitor host server. The default port is 6716.
Note: Before selecting a port, verify that the port is available on your system with the TSO commands NETSTAT and NETSTAT PORTL.
TZ
Time zone selector. The default is EST5EDT. The default time zone is UTC +5 hours (Eastern Standard Time (EST) Eastern Daylight Savings Time (EDT)). Change this to represent your time zone. You can find additional information here: UNIX System Services Command Reference (SA22-7802).

The following definitions are optional. If omitted, default values are applied as specified in the following list:

_BPXK_SETIBMOPT_TRANSPORT=<tcpip stack name>
Specifies the name of the TCPIP stack to be used. The default is TCPIP. Uncomment and change to the requested TCPIP stack name, as defined in the TCPIPJOBNAME statement in the related TCPIP.DATA.
Note: Coding a SYSTCPD DD statement in the server JCL does not set the requested stack affinity.
APPLID
Specifies the application identifier used for identifying JES Job Monitor to your security software. The default is FEKAPPL. Uncomment and change to the correct application ID.
AUTHMETHOD
The default is SAF, which means that the System Authorization Facility (SAF) security interface is used. Do not change unless directed to do so by the IBM® support center.
CODEPAGE
The workstation code page. The default is UTF-8. The workstation code page is set to UTF-8 and generally should not be changed. You might need to uncomment the directive and change UTF-8 to match the workstation's code page if you have difficulty with NLS characters, such as the currency symbol.
CONCHAR
Specifies the JES console command character. CONCHAR defaults to CONCHAR=$ for JES2, or CONCHAR=* for JES3. Uncomment and change to the requested command character.
CONSOLE_NAME
Specifies the name of the EMCS console used for issuing commands against jobs (Hold, Release, Cancel and Purge). The default is JMON. Uncomment and change to the correct console name, using the guidelines that follow.
  • CONSOLE_NAME must be either a console name with two to eight alphanumeric characters, or &SYSUID.
  • If a console name is specified, a single console by that name is used for all users. If the console by that name happens to be in use, then the command issued by the client will fail.
  • If &SYSUID is specified, the client user ID is used as the console name. Thus a different console is used for each user. If the console by that name happens to be in use (for example, the user is using the SDSF ULOG), then the command issued by the client might fail, depending on the GEN_CONSOLE_NAME setting.

No matter which console name is used, the user ID of the client requesting the command is used as the LU of the console, leaving a trace in syslog messages IEA630I and IEA631.

IEA630I OPERATOR console NOW ACTIVE,   SYSTEM=sysid, LU=id
IEA631I OPERATOR console NOW INACTIVE, SYSTEM=sysid, LU=id
GEN_CONSOLE_NAME
Enables or disables automatic generating of alternative console names. The default is OFF. Uncomment and change to ON to enable alternative console names.

This directive is only used when CONSOLE_NAME=&USERID and the user ID is not available as console name.

If GEN_CONSOLE_NAME=ON, an alternative console name is generated by appending a single numeric digit to the user ID. The digits 0 through 9 are attempted. If no available console is found, the command issued by the client fails.

If GEN_CONSOLE_NAME=OFF, the command issued by the client fails.

Note: The only valid settings are ON and OFF.
LIMIT_COMMANDS
Defines against which jobs the user can issue selected JES commands (Show JCL, Hold, Release, Cancel, and Purge). The default (LIMIT_COMMANDS=USERID) limits the commands to jobs owned by the user. Uncomment this directive and specify LIMITED or NOLIMIT to allow the user to issue commands against all spool files, if permitted by your security product.
Table 1. LIMIT_COMMANDS command permission matrix
LIMIT_COMMANDS Job owner is the user Job owner is not the user
USERID (default) Allowed Not allowed
LIMITED Allowed Allowed only if explicitly permitted by security profiles
NOLIMIT Allowed Allowed if permitted by security profiles or when the JESSPOOL class is not active
Note: The only valid settings are USERID, LIMITED, and NOLIMIT.
LIMIT_CONSOLE
Defines authority level of the EMCS console that is used for executing actions.
Note: The only valid settings are LIMITED (default value) and NOLIMIT.
LIMIT_VIEW
Defines what output you can view. With the default (LIMIT_VIEW=NOLIMIT) you can view all JES output, if permitted by your security product. Uncomment this directive and specify USERID to limit the view to output.
Note: The only valid settings are USERID and NOLIMIT.
LISTEN_QUEUE_LENGTH
The TCP/IP listen queue length. The default is 5. Do not change unless directed to do so by the IBM Software Support.
LOOPBACK_ONLY
Defines whether JES Job Monitor can be accessed from outside this z/OS® system.
Note: The only valid settings are ON(default value) and OFF.
MAX_DATASETS
The maximum number of spooled output data sets that Job Monitor will return to the client (for example, SYSOUT, SYSPRINT, SYS00001, and so on). The default is 32. The maximum value is 2147483647.
MAX_THREADS
Maximum number of users that can be using one Job Monitor at a time. The default is 200. The maximum value is 2147483647. Increasing this number may require you to increase the size of the Job Monitor address space.
TIMEOUT
The length of time, in seconds, before a thread is killed due to lack of interaction with the client. The default is 3600 (1 hour). The maximum value is 2147483647. TIMEOUT=0 disables the function.
TIMEOUT_INTERVAL
The number of seconds between timeout checks. The default is 1200. The maximum value is 2147483647.
TRACE_STORAGE
Enable storage tracing. The default is OFF. Uncomment this directive and specify ON to write a storage report to DD SYSOUT after each command. The only valid values are ON and OFF. Use only when directed by the IBM support center.
SEARCHALL
Collect APPC and z/OS UNIX output that matches the JES Job Monitor filter, for example output written to SYSOUT by a Developer for System z® CARMA server started using the CRASTART method. The default is OFF. Uncomment this directive and specify ON to collect the additional spool files. The only valid values are ON and OFF.
SUBMIT_TIMEOUT
The number of seconds that Progress Monitor will wait for the completion of the TSO_TEMPLATE job. The default is 30. The maximum value is 2147483647.
Note: SUBMIT_TIMEOUT has no effect unless SUBMITMETHOD=TSO is also specified.
SUBMITMETHOD=TSO
Submit jobs through TSO. The default (SUBMITMETHOD=JES) submits jobs directly into JES. Uncomment this directive and specify TSO to submit the job through TSO SUBMIT command. This method allows TSO exits to be invoked; however, it has a performance drawback and for that reason it is not recommended.
Notes:
  1. The only valid settings are TSO and JES.
  2. If SUBMITMETHOD=TSO is specified, then you must also define TSO_TEMPLATE.
TSO_TEMPLATE
Wrapper JCL for submitting the job through TSO. The default value is hlq.SBLZSAMP(BLZTSO). This statement refers to the fully qualified member name of the JCL to be used as a wrapper for the TSO submit. See the SUBMITMETHOD statement for more information.
Notes:
  1. A sample wrapper job is provided in BLZ.SBLZSAMP(BLZTSO). Refer to this member for more information about the customization needed.
  2. TSO_TEMPLATE has no effect unless SUBMITMETHOD=TSO is also specified.