Statement Summary

Table 1. SETNAME Summary
Variable	Value
Required/Optional Statement	Optional
Statement Default	None
Placement in Initialization Stream	This statement must follow the ENDJSAM statement. However, the order of SETNAME statements in your initialization stream affects the order that JES3 uses to select devices. For example, if you want to reserve a group of devices for selection only after all devices from another group are allocated, order your SETNAME statements as follows: `SETNAME,XTYPE=LARGE,NAMES=(3380,DISK) SETNAME,XTYPE=SMALL,NAMES=(3380,DISK,XYZ)` In the preceding example, JES3 will make an initial attempt to allocate devices from the large group when users specify UNIT=3380 or UNIT=DISK in their JCL. If no devices are available in the large group, JES3 will attempt to allocate a device from the small group. Defining SETNAME statements in this order improves the chances that devices in the small group will be available when a user specifies UNIT=XYZ.
Coding Considerations	The XTYPE parameter on this statement must match the first operand of the XTYPE parameter on one or more DEVICE statements. The DEVPOOL parameter on the GROUP statement may match the POOLNAMS parameter on the SETNAME statement. All names specified on the TYPE parameter of the HWSNAME statements must be specified on the NAMES parameter of the SETNAME statements. You can define a maximum of 255 unique XTYPE parameters on a SETNAME initialization statement.
Security Usage	None
Performance Considerations	None
Initialization Stream Overrides	None
Restart or Command Modification	Cold, warm, or hot start with refresh for all parameters. The loss of an esoteric or generic name caused by omitting this statement will cause jobs that use the named device to terminate abnormally.