CHGDEVSNUF (Change Device Description (SNUF))

CHGDEVSNUF Command syntax diagram

 

Purpose

The Change Device Description (SNUF) (CHGDEVSNUF) command changes the description of a Systems Network Architecture Upline Facility (SNUF) device. The changes are implemented the next time the device is varied on.

 

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 two hexadecimal characters ranging from 01 through FF for the local address of the SNUF devices.

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.

PGMSTRRQS

Specifies whether this device is reserved for host system call by use of the Program Start Request (PGMSTRRQS) parameter.

*SAME: The value does not change.

*NO: This device is not reserved for call by use of the PGMSTRRQS parameter.

*YES: This device is reserved for call by use of the PGMSTRRQS parameter.

SPCHOSTAPP

Specifies whether SNUF customizes support for special host applications outside the Customer Information Control System for Virtual Storage (CICS/VS) or Information Management System for Virtual Storage (IMS/VS) application layer.

*SAME: The value does not change.

*NONE: SNUF does not customize support for special host applications.

*FLASH: SNUF customizes support for the Federal Link Access for Secondary Half-sessions (*FLASH) protocol application.

APPID

Specifies the virtual telecommunications access method (VTAM) Application Identifier sent with the sign-on message.

*SAME: The value does not change.

application-identifier: Specify the VTAM application identifier.

HOST

Specifies the type of host system with which the device communicates.

*SAME: The value does not change.

*CICS: The host system type is CICS/VS.

*IMS: The host system type is IMS/VS.

*IMSRTR: The host system type is Information Management System Ready to Receive (IMSRTR).

*ADCS: The host system type is Advanced Data Communication for Stores (ADCS).

RCDLEN

Specifies the maximum record length allowed when communicating with this device. The maximum value for this parameter is 32767 bytes. The value must not exceed the block length value for this device.

*SAME: The value does not change.

record-length: Specify the maximum record length (in bytes) to use with this device file. The value must be at least the size of the largest record sent. If a record is longer than the specified record length, a run time error occurs when the record is sent or received. Valid values range from 1 through 32767 bytes for SNUF communications. For BSCEL communications, the maximum record length is 8192 bytes.

BLKLEN

Specifies the maximum block length allowed when communicating with this device. The maximum value for this parameter is 32767 bytes. This value must be greater than or equal to the record length.

*SAME: The value does not change.

block-length: Specify the maximum block length (in bytes) of records sent. The value must be at least the size of the largest record sent. Valid values range from 1 through 32767.

DFTPGM

Specifies the qualified name of the default program called if a program start request is received and no program is specified.

*SAME: The default program does not change.

The name of the default program can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

program-name: Specify the name of the default program.

HCPEML

Specifies the Host Command Processor (HCP) emulation to be done by the iSeries Retail Licensed Program in support of the Advanced Data Communications for Stores (*ADCS) value on the HOST parameter. HCPEML can only be specified when *ADCS is the value for the HOST parameter.

*SAME: The value does not change.

*STRUSRPGM: The host is running ADCS and will use this Device Description for the Start User Program (SUP) emulated session.

3651: The host is running ADCS and will use this Device Description for a 3651 HCP emulated session.

3684: The host is running ADCS and will use this Device Description for a 3684 HCP emulated session.

4680: The host is running ADCS and will use this Device Description for a 4680 HCP emulated session.

4684: The host is running ADCS and will use this Device Description for a 4684 HCP emulated session.

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 CHGDEVSNUF

CHGDEVSNUF   DEVD(SNUFDEV01)
  PGMSTRRQS(*YES)  DFTPGM(INQUIRY)

This command changes the device description for communications device SNUFDEV01, reserving it for host system call by the use of a program start request. The default program is changed to INQUIRY.

Error messages for CHGDEVSNUF

*ESCAPE Messages

CPF2618

Device description &1 not changed.