Create Line Desc (Fax) (CRTLINFAX)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Line Description (Fax) (CRTLINFAX) command creates 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, Positional 1 |
| RSRCNAME | Resource names | Values (up to 2 repetitions): Name | Required, Positional 2 |
| ONLINE | Online at IPL | *YES, *NO | Optional |
| VRYWAIT | Vary on wait | 15-180, *NOWAIT | Optional |
| TEXT | Text 'description' | Character value, *BLANK | Optional |
| CTL | Attached nonswitched ctls | Name | Optional |
| AUT | Authority | Name, *CHANGE, *ALL, *USE, *EXCLUDE, *LIBCRTAUT | 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.
- 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).
- *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.
- *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.
- *BLANK
- Text is not specified.
- character-value
- Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
Attached nonswitched ctls (CTL)
Specifies the name of the controller description to which this object is attached.
Note: This parameter is valid only when the associated controller description has been created before this line description.
| Top |
Authority (AUT)
Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
- *CHANGE
- The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
- *ALL
- The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the object.
- *USE
- The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
- *EXCLUDE
- The user cannot access the object.
- *LIBCRTAUT
- The system determines the authority for the object by using the value specified for the Create authority (CRTAUT) parameter on the Create Library (CRTLIB) command for the library containing the object to be created. If the value specified for the CRTAUT parameter is changed, the new value will not affect any existing objects.
- name
- Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.
| Top |
Examples
CRTLINFAX LIND(FAXLINE) RSRCNAME(LIN041 LIN042)
This command creates fax line description named FAXLINE with resource names of LIN041 and LIN042.
| Top |
| Top |