CHGDEVFNC (Change Device Description (Finance))
CHGDEVFNC Command syntax diagram
Purpose
The Change Device Description (Finance) (CHGDEVFNC) command changes the description of a finance device.
Required Parameters
- DEVD
- Specifies the name of the device description being changed.
Optional Parameters
- LOCADR
- Specifies the local location address. Specify a 2-character hexadecimal value ranging from 01 through FF.
*SAME: The value does not change.
location-address: Specify 2 hexadecimal characters with a value ranging from 01 to FF for the local location address.
Controllers and valid numbers of attachable devices are as follows:
- 3694
- 01-04
- 4701
- 01-FF
- 4702
- 01-FF
- 4730
- 01-03
- 4731
- 01-02
- 4732
- 01-02
- 4736
- 01-02
- *FBSS
- 01-FF
Note: The value 01 is only valid for ICF finance communications when (TYPE(*FNCICF) is specified on the Create Device Description (Finance) (CRTDEVFNC) command. - ONLINE
- Specifies whether this object is automatically varied on at initial program load (IPL).
*SAME: The value does not change.
*YES: The device is automatically varied on at IPL.
*NO: This device is not automatically varied on at IPL.
- MAXLENRU
- Specifies the default maximum request unit (RU) length that can be sent or received by the local systems if the maximum size is not specified in the bind.
*SAME: The value does not change.
*CALC: The system determines the value to use.
maximum-length-request-unit: Specify a value ranging from 8 to 4096 bytes for the maximum size of the request unit.
- INACTTMR
- Specifies an inactivity timer (time-out) value. This parameter also specifies what happens when the time-out value is exceeded, dependent on other attributes of the device:
- For devices connected using SNA pass-through (SNPT) support, the user is informed by a message to QSYSOPR and the session is ended when the amount of time that the device is not bound to a host application exceeds the time-out value. The user must reestablish the connection and session.
- For all other attachments, valid values range from 1 through 30 minutes.
Note: This timer is not used by devices allocated to a subsystem (normal interactive use) because the subsystem always has a file open for the device. The timer is used by batch jobs that open and close files for the device. *SAME: The value does not change.
*NOMAX: Maximum inactivity time is not tracked.
*SEC15: A 15-second time-out period is used.
*SEC30: A 30-second time-out period is used.
inactivity-timer: Specify a time-out value.
- ACTTMR
- Specifies, for switched lines, the amount of time that the SNA passthrough support waits for the device to respond to the activation request from the host iSeries 400. If the device does not respond within this time, it is considered not available.
*SAME: The value does not change.
activation-time: Specify a number ranging from 1 through 2550 indicating the number of seconds before the device is considered not available.
- SNPTDEV
- Specifies the name of the associated SNA pass-through device that is attached to a host or advanced program-to-program communications (APPC) controller.
*SAME: The value does not change.
*NONE: No name is specified.
associated-device-name: Specify the name of a device that is attached to a host or an APPC controller that is associated with this device.
- SNPTGRP
- Specifies the name configured for a group of host devices in a configuration list (see CRTCFGL command). This indicates that this device is associated with any one of the devices in that group which is available.
This parameter is only allowed when *SNPT is specified for the DEVCLS parameter.
*SAME: The value does not change.
*NONE: No name is specified.
group-name: Specify the name configured for a group of host devices that must be associated with this device.
- TEXT
- Specifies the text that briefly describes the program and its function. More information is in Commonly used parameters.
*SAME: The value does not change.
*BLANK: Text is not specified.
'description': Specify no more than 50 characters of text, enclosed in apostrophes.
Example for CHGDEVFNC
CHGDEVFNC DEVD(FNCDSP1) ONLINE(*YES)This command changes the device description for the finance device FNCDSP1 so that the device will be varied on at IPL.
Error messages for CHGDEVFNC
*ESCAPE Messages
- CPF2618
- Device description &1 not changed.