CRTDEVSNUF (Create Device Description (SNUF))

CRTDEVSNUF Command syntax diagram

 

Purpose

The Create Device Description (SNUF) (CRTDEVSNUF) command creates a device description for a Systems Network Architecture Upline Facility (SNUF) device. More information about using this command is in the Communications Configuration

book.

 

Required Parameters

DEVD

Specifies the name of the device description being created.

LOCADR

Specifies the local location address. Specify a 2-character hexadecimal value ranging from 01 through FE.

RMTLOCNAME

Specifies the remote location name of the system with which this object communicates.

 

Optional Parameters

ONLINE

Specifies whether this object is automatically varied on at initial program load (IPL).

*YES: The device is automatically varied on at IPL.

*NO: This device is not automatically varied on at IPL.

CTL

Specifies the name of the controller description to which this object is attached.

PGMSTRRQS

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

*NO: This device is not reserved for a start program request.

*YES: This device is reserved for a start program request.

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.

*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.

HOST

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

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

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

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

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

RCDLEN

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

512: The record length is 512.

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. This value must be greater than or equal to the record length.

512: The block length is 512.

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 program called if a program start request is received from the host system not using *EXEC/*EXEX/*TXTC/*TXTX format. This parameter is required if the value specified for the program start request parameter is *YES.

The name of the program name 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.

AUT

Specifies the authority given to users who do not have specific authority to the device description, who are not on an authorization list, and whose user group has no specific authority to the device description.

*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management 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 device description.

*USE: The user can perform basic operations on the device description, such as running a program or reading a file. The user cannot change the device description. *USE authority provides object operational authority, read authority, and execute authority.

*EXCLUDE: The user cannot access the device description.

authorization-list-name: Specify the name of the authorization list used.

DEPLOCNAME

Specifies the dependent local location name used for dependent LU requestor (DLUR), providing additional security for the connection. If this name is filled in, an activation request (SNA ACTLU) from a dependent LU server (DLUS) node must reference this name or it is rejected.

Remote DLUS nodes may optionally accept unsolicited reply PSIDs (Product Set IDs) from the iSeries 400 for auto-definition of LUs at the DLUS node. If so, then this name is sent to the DLUS node in the reply PSID and it is returned on the ACTLU request.

If unsolicited reply PSIDs are not supported by the DLUS node, then there will have to be close coordination of the PU name definitions on both systems.

*NONE: No location name is defined.

dependent-location-name: Specify the dependent location name used for DLUR applications.

HCPEML

Specifies the Host Command Processor (HCP) emulation to be done by the iSeries 400 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.

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

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

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

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

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

TEXT

Specifies the text that briefly describes the device file. More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CRTDEVSNUF

CRTDEVSNUF   DEVD(SNUFDEV02)  LOCADR(FE)
  RMTLOCNAME(DETROIT)  CTL(SNUFCTL01)
  PGMSTRRQS(*YES)  DFTPGM(PAYROLL)

This command creates a device description for a SNUF communications device named SNUFDEV02. The device is attached to the communications controller SNUFCTL01 in Detroit, and is at location address X'FE'. The device will be program start request-capable and the default program is PAYROLL.

Error messages for CRTDEVSNUF

*ESCAPE Messages

CPF261A

Device description &1 not created due to errors.

CPF2654

Device description &1 created but possibly not usable.