Job Monitor configuration file BLZJCNFG

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

Customize the sample Job Monitor configuration member hlq.SBLZSAMP(BLZJCNFG), as shown 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
#CODEPAGE=UTF-8
#CONCHAR=$
#CONSOLE_NAME=JMON
#GEN_CONSOLE_NAME=OFF
#LIMIT_COMMANDS=NOLIMIT
#LIMIT_VIEW=USERID
#LISTEN_QUEUE_LENGTH=5
#MAX_DATASETS=32
#MAX_THREADS=200
#TIMEOUT=3600
#TIMEOUT_INTERVAL=1200
#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 below:

_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.
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 desired console name, using the guidelines below.
  • 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
  Job owner
LIMIT_COMMANDS User Other
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_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.
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.
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.
Note:
  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.
Note:
  1. A sample wrapper job is provided in BLZ.SBLZSAMP(BLZTSO). Refer to this member for more information on the customization needed.
  2. TSO_TEMPLATE has no effect unless SUBMITMETHOD=TSO is also specified.

Feedback