The Change Line Description (Fax) (CHGLINFAX) command changes a line description for a facsimile (fax) line.

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

Line description (LIND)

Specifies the name of the line description

This is a required parameter.

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.

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.

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:

1. 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.
2. 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.

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.

Examples

CHGLINFAX   LIND(FAXLINE)  RSRCNAME(LIN031 LIN032)

This command changes the resource names for fax line description FAXLINE to LIN041 and LIN042.

Error messages

*ESCAPE Messages

CPF261E

Line description &1 not changed.