Change Line Desc (Fax) (CHGLINFAX)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Line Description (Fax) (CHGLINFAX) command changes a line description for a facsimile (fax) line.
Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| LIND | Line description | Name | Required, Key, Positional 1 |
| RSRCNAME | Resource names | Single values: *SAME Other values (up to 2 repetitions): Name |
Optional |
| ONLINE | Online at IPL | *SAME, *YES, *NO | Optional |
| VRYWAIT | Vary on wait | 15-180, *SAME, *NOWAIT | Optional |
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| Top |
| Top |
Resource names (RSRCNAME)
Specifies the resource names that describe the fax ports.
Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *CMN specified for the TYPE parameter to help determine the resource name.
The resource name consists of the input/output adapter (IOA) resource name and the port number on the IOA. For example, if the resource name of the IOA is LIN01, the resource names for ports 1 and 2 are LIN011 and LIN012.
The resource name for both ports of the fax IOA must be specified. All lines specified must be attached to the same input/output processor.
- *SAME
- The value does not change.
- rsrcname-1
- Specify the first resource name to be used to describe the fax ports.
- rsrcname-2
- Specify the second resource name to be used to describe the fax ports.
| Top |
Online at IPL (ONLINE)
Specifies whether this object is automatically varied on at initial program load (IPL).
- *SAME
- The value does not change.
- *YES
- The line is automatically varied on at initial program load (IPL).
- *NO
- This line is not automatically varied on at IPL.
| Top |
Vary on wait (VRYWAIT)
Specifies whether the line is varied on asynchronously or synchronously. For synchronous vary on, this parameter specifies how long the system waits for the vary on to complete.
- *SAME
- The value does not change.
- *NOWAIT
- The system does not wait for vary on completion. The line is varied on asynchronously.
- vary-on-wait
- Specify the time (in seconds) to wait. Valid values range from 15 through 180. The system waits until the line is varied on, or until the specified time passes, before completing the Vary Configuration (VRYCFG) command.
Notes:
- When ONLINE(*YES) is used, specifying a wait time in the line description affects system IPL time. In such cases, system IPL time is influenced by the amount of time required to synchronously vary on the line or reach the wait-time value.
- The time required to vary on a line is the time it takes to:
- Put tasks in place to manage the line
- Activate the communications I/O processor (IOP), including downloading the IOP model-unique Licensed Internal Code
- Establish the communications tasks and processes
Normal vary-on time ranges from 5 through 45 seconds, but can be longer, depending on the system, line protocol, and other factors.
| Top |
Text 'description' (TEXT)
Specifies text that briefly describes the line description.
- *SAME
- The value does not change.
- *BLANK
- Text is not specified.
- character-value
- Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
Examples
CHGLINFAX LIND(FAXLINE) RSRCNAME(LIN031 LIN032)
This command changes the resource names for fax line description FAXLINE to LIN041 and LIN042.
| Top |
| Top |