Setting local options
About this task
To modify the local options file, localopts, do what follows:
- Copy the localopts file using ftp to a UNIX or Windows NT workstation. For example:
ftp 124.56.34.130 User: root Password: xxxxx ftp> namefmt 1 ftp> put /Maestro/localopts ftp> quit - Edit the localopts file. For more information, see the Administration Guide.
ftp 124.56.34.130 User: root Password: xxxxx ftp> namefmt 1 ftp> get localopts /Maestro/localopts ftp> quit - After copying the file back to the IBM i,
use the following command to set the file ownership to QMAESTRO:
CHGOWN OBJ(’/maestro/localopts’) NEWOWN(QMAESTRO)
Changes do not take effect until HCL Workload Automation is stopped and restarted.
The syntax for the localopts file
is described in the following table. Entries are not case-sensitive.
| Local option syntax | Default value |
|---|---|
| # comment | |
| bm check file = seconds | 120 |
| bm check status = seconds | 300 |
| bm check until = seconds | 300 |
| bm look = seconds | 30 |
| bm read = seconds | 15 |
| bm stats = on|off | off |
| bm verbose = on|off | off |
| jm job table size = entries | 160 |
| jm look = seconds | 300 |
| jm nice = value | 0 |
| jm no root = yes|no | no |
| jm read = seconds | 10 |
| merge stdlists = yes|no | yes |
| mm read = seconds | 15 |
| mm response = seconds | 600 |
| mm retry link = seconds | 600 |
| mm sound off = yes|no | no |
| mm unlink = seconds | 960 |
| nm ipvalidate = none|full | none |
| nm mortal = yes|no | no |
| nm port = tcpaddr | 31111 |
| nm read = seconds | 60 |
| nm retry = seconds | 800 |
| stdlist width = columns | 80 |
| syslog local = facility | -1 |
| thiscpu = wkstation | thiscpu |
| wr read = seconds | 600 |
| wr unlink = seconds | 600 |
| mozart directory = mozart_share | none |
| unison network directory = unison_share | none |
| parameters directory = parms_share | none |
- # comment
- Treat everything from the pound sign to the end-of-line as a comment.
- bm check file
- Enter the minimum number of seconds Batchman will wait before rechecking for the existence of a file that is used as a dependency.
- bm check status
- Enter the number of seconds Batchman will wait between checking the status of an internetwork dependency.
- bm check until
- Enter the maximum number of seconds Batchman will wait before reporting the expiration of an Until time for job or job stream. Decreasing the value below the default setting may unduly load the system. If it is set below the value of local option bm read, the value of bm read is used in its place.
- bm look
- Enter the minimum number of seconds Batchman will wait before scanning and updating its Production Control file.
- bm read
- Enter the maximum number of seconds Batchman will wait for a message in its message file.
- bm stats
- Enter on to have Batchman send its startup and shutdown statistics to its standard list file. Enter off to prevent Batchman statistics from being sent to its standard list file.
- bm verbose
- Enter on to have Batchman send all job status messages to its standard list file. Enter off to prevent the extended set of job status messages from being sent to the standard list file.
- jm job table size
- Enter the size, in number of entries, of the job table used by Jobman.
- jm look
- Enter the minimum number of seconds Jobman will wait before looking for completed jobs, and performing general job management tasks.
- jm nice
- UNIX only. Enter the nice value to be applied to jobs launched by Jobman.
- jm no root
- For UNIX enter yes to prevent Jobman from launching root
jobs. Enter no to allow Jobman to launch root jobs.
For IBM i enter yes to prevent Jobman from launching QSECOFR jobs. Enter no to allow Jobman to launch QSECOFR jobs.
- jm read
- Enter the maximum number of seconds Jobman will wait for a message in its message file.
- merge stdlists
- Enter yes to have all HCL Workload Automation control processes, except Netman, write their console messages to a single standard list file. The file is given the name MAESTRO. Enter no to have each process write to its own standard list file.
- mm read
- Enter the rate, in seconds, at which Mailman checks its mailbox for messages. If omitted, the default is 15 seconds. Defining a lower value causes HCL Workload Automation to run faster at the expense of using more processor time.
- mm response
- Enter the maximum number of seconds Mailman will wait for a response before reporting that another workstation is not responding. The response time should not be less than 90 seconds.
- mm retry link
- Enter the maximum number of seconds Mailman will wait, after unlinking from a non-responding workstation, before it attempts to re-link to the workstation.
- mm sound off
- Determines how Mailman responds to a conman tellop ? command. Enter yes to have Mailman display information about every task it is performing. Enter no to have Mailman send only its own status.
- mm unlink
- Enter the maximum number of seconds Mailman will wait before unlinking from another workstation that is not responding. The wait time should not be less than the response time entered for the local option nm response.
- nm ipvalidate
- Enter full to enable IP address validation and, if IP validation fails, the connection is not allowed. Enter none to allow connections when IP validation fails.
- nm mortal
- Enter yes to have netman quit when all of its child processes have stopped. Enter no to have Netman keep running when its child processes have stopped.
- nm port
- Enter the TCP port number that Netman responds to on this computer. This must match the TCP address in the computer’s workstation definition.
- nm read
- Enter the maximum number of seconds Netman will wait for a connection request before checking its message queue for stop/start commands.
- nm retry
- Enter the maximum number of seconds Netman will wait before retrying a connection that has failed.
- stdlist width
- Defines the maximum width of HCL Workload Automation console messages. You can enter a column number in the range 1-255, and lines are wrapped at that column or before, depending on the presence of imbedded carriage control characters. Enter a negative number, or zero, to ignore line width.
- syslog local
- UNIX computers only. Enables or disables HCL Workload Automation system logging. Enter -1 to turn off system logging for HCL Workload Automation. Enter a number 0-7 to turn on system logging, and have HCL Workload Automation use the corresponding local facility (LOCAL0-LOCAL7) for its messages. Enter any other number to turn on system logging and have HCL Workload Automation use the USER facility for its messages.
- thiscpu
- The HCL Workload Automation name of this workstation.
- wr read
- Enter the number of seconds Writer will wait for an incoming message before checking for a termination request from Netman.
- wr unlink
- Enter the number of seconds Writer will wait before exiting if no incoming messages are received. The lower limit is 120, and the default is 600.
- mozart directory
- Not used.
- unison network directory
- Not used.
- parameters directory
- Not used.