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: - The only valid settings are TSO and JES.
- 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: - A sample wrapper job is provided in BLZ.SBLZSAMP(BLZTSO).
Refer to this member for more information on the customization needed.
- TSO_TEMPLATE has no effect unless SUBMITMETHOD=TSO is
also specified.