Configuration Overview
What is it?
The configuration section covers all parameters that control how the OS 2200 LSAM operates: its connection to OpCon, security credentials, job limits, console message behavior, and optional features such as JORS and BIS. The LSAM configuration file contains information needed to set the correct options for the LSAM's communication with SMANetCom and to activate optional features. Configuration must be reviewed and set before the LSAM is started for the first time, and must be updated whenever network settings, credentials, or optional features change.
All configuration changes are made through the LSAMCFG/ECL configuration program, which stores values in the LSAM TIP communications file.
Critical settings
The following parameters must be correct before starting the LSAM for the first time:
| Parameter | Purpose |
|---|---|
| RSI User-ID | Provides the user-ID and password for the LSAM to establish a DEMAND session. The absence of a valid user-ID/password diminishes the LSAM's job starting and monitoring capabilities. |
| Default User-ID for ST keyin | Provides a default user-ID used by the LSAM when issuing a console ST command for jobs that do not have user-IDs. |
| Default Account for ST keyin | Provides a default account used by the LSAM when issuing a console ST command for jobs that do not have an account. The Default User-ID must be valid for the Default Account. |
| TSU Process Name and Password | Provides the information needed to establish network communications through either CMS-1100 or CpComm. Invalid or missing Process name or password causes the LSAM and associated programs to terminate. |
| Host Machine Name | Defines the batch job machine. Must match the Host Name on the Machines screen of the Enterprise Manager. |
| Host Machine Max Jobs | Determines the maximum number of jobs the LSAM is allowed to process concurrently. |
| Port Number | Defines the port for communication between the LSAM and SMANetCom. |
Run the Configuration Program
- Set the LSAM file qualifier:
@QUAL [LSAM-qualifier] - Start the configuration procedure. From a DEMAND session, enter:
@ADD *SKDPRG.LSAMCFG/ECL - At the prompt, enter the line number for the configuration value to change. Refer to the Configuration Settings tables for help with setting the values.
- Transmit the screen.
- Enter the new value for the selected item.
- Transmit the screen.
- Repeat steps 3–6 as necessary to set all values for the local configuration.
- After all desired updates have been entered, transmit a blank entry.
- A prompt of
UPDATE OR CANCEL (UPD TO UPDATE, XMIT TO CANCEL)is presented. EnterUPDand transmit to save the changes. Transmitting a blank entry does not save the changes.
In this section
- Configuration Settings — complete list of all configuration parameters and valid values
- Page One Settings — primary LSAM configuration parameters
- Page Two Settings — secondary LSAM configuration parameters
- Console Message Display Level — controls which job status messages appear on the system console
- Configure BIS — BIS/MAM-specific configuration parameters
- Configure JORS — Job Output Retrieval System configuration
- Additional Settings — advanced configuration options
Frequently Asked Questions
When do I need to re-run LSAMCFG?
Run LSAMCFG/ECL any time a critical network or security parameter changes: the OpCon server address, port number, machine name, RSI user-ID or password, or CpComm/CMS process credentials. Optional features such as JORS or SMAMSC also require configuration changes to enable.
Do configuration changes take effect immediately?
No. Configuration changes are written to the TIP file and take effect the next time the LSAM is started. The LSAM must be stopped and restarted for changes to apply.
Can I back up and restore configuration parameters?
Yes. The LSAM provides LPARMINI/ECL to initialize the Configuration Parameters Backup file and LPARMRES/ECL to restore saved configuration values. SMA recommends running a configuration update immediately after initializing the Backup file to establish a known-good baseline. See Additional Features for details.