Change Device Desc (SNUF) (CHGDEVSNUF)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Change Device Description (SNUF) (CHGDEVSNUF) command changes a device description for a Systems Network Architecture Upline Facility (SNUF) device.

Top

Parameters

Keyword Description Choices Notes
DEVD Device description Name Required, Key, Positional 1
LOCADR Local location address *SAME, 01, 02, 03, 04, 05, 06, 07, 08, 09, 0A, 0B, 0C, 0D, 0E, 0F, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 1A, 1B, 1C, 1D, 1E, 1F, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 2A, 2B, 2C, 2D, 2E, 2F, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 3A, 3B, 3C, 3D, 3E, 3F, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 4A, 4B, 4C, 4D, 4E, 4F, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 5A, 5B, 5C, 5D, 5E, 5F, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 6A, 6B, 6C, 6D, 6E, 6F, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 7A, 7B, 7C, 7D, 7E, 7F, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 8A, 8B, 8C, 8D, 8E, 8F, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 9A, 9B, 9C, 9D, 9E, 9F, A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, AA, AB, AC, AD, AE, AF, B0, B1, B2, B3, B4, B5, B6, B7, B8, B9, BA, BB, BC, BD, BE, BF, C0, C1, C2, C3, C4, C5, C6, C7, C8, C9, CA, CB, CC, CD, CE, CF, D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, DA, DB, DC, DD, DE, DF, E0, E1, E2, E3, E4, E5, E6, E7, E8, E9, EA, EB, EC, ED, EE, EF, F0, F1, F2, F3, F4, F5, F6, F7, F8, F9, FA, FB, FC, FD, FE, FF Optional
ONLINE Online at IPL *SAME, *YES, *NO Optional
PGMSTRRQS Program start request capable *SAME, *YES, *NO Optional
SPCHOSTAPP Special host application *SAME, *NONE, *FLASH Optional
APPID Application identifier Name, *SAME Optional
HOST Host type *SAME, *CICS, *IMS, *IMSRTR, *ADCS Optional
RCDLEN Record length 1-32767, *SAME Optional
BLKLEN Block length 1-32767, *SAME Optional
DFTPGM Default program Single values: *SAME
Other values: Qualified object name
Optional
Qualifier 1: Default program Name
Qualifier 2: Library Name, *LIBL, *CURLIB
HCPEML HCP emulation *SAME, *STRUSRPGM, 3651, 3684, 4680, 4684 Optional
TEXT Text 'description' Character value, *SAME, *BLANK Optional
Top

Device description (DEVD)

Specifies the name of the device description being changed.

This is a required parameter.

Top

Local location address (LOCADR)

Specifies the local location address for this device.

Valid values range from 01 to FF.

*SAME
The value does not change.
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
This device is varied on automatically at IPL.
*NO
This device is not varied on automatically at IPL.
Top

Program start request capable (PGMSTRRQS)

Specifies whether this device is reserved for host system call through a Program Start Request (PSR).

*SAME
The value does not change.
*NO
This device is not reserved for a PSR request.
*YES
This device is reserved for a PSR request.
Top

Special host application (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 Reserve Flash application.
Top

Application identifier (APPID)

Specifies the VTAM Application Identifier sent with the log-on message.

*SAME
The value does not change.
Top

Host type (HOST)

Specifies the type of host system with which the device will communicate.

*SAME
The value does not change.
*CICS
The host system type is CICS/VS.
*IMS
The host system type is IMS/VS.
*IMSRTR
The Information Management System is the host system. RTR (return-to-ready) commands will be used in communicating with the host system.
*ADCS
The Advanced Data Communications for Stores is the host system.
Top

Record length (RCDLEN)

Specifies the maximum record length allowed when communicating with this device.

Valid values range from 1 to 32767.

The value must be at least the size of the largest record to be sent, but must not exceed the buffer size specified on the line description (MAXBUFFER parameter) to which this device is attached.

*SAME
The value does not change.
Top

Block length (BLKLEN)

Specifies the maximum block length allowed when communicating with this device.

The possible values are from 1 to 32767.

The value must be at least the size of the largest record to be sent, but must not exceed the buffer size specified on the line description (MAXBUFFER parameter) to which this device is attached.

*SAME
The value does not change.
Top

Default program (DFTPGM)

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

The program is specified by its qualified name (library-name/program-name).

*SAME
The value does not change.

The possible library values are:

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.
library-name
Specify the library where the object is located.
Top

HCP emulation (HCPEML)

Specifies the Host Command Processor (HCP) emulation to be performed.

*SAME
The value does not change.
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.
*STRUSRPGM
The host is running ADCS and will use this device description for the Start User Program (SUP) emulated session.
Top

Text 'description' (TEXT)

*SAME
The text (if any) does not change.
*BLANK
No text is specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.
Top

Examples

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.

Top

Error messages

*ESCAPE Messages

CPF2618
Device description &1 not changed.
Top