IEE313I
{HARDCOPY|sdddd} UNIT REF. INVALID

Explanation

While processing a command, the system detected one of the following errors:
  1. The unit, console identifier, or console name specified on the command indicates a device type that cannot be used for the purpose intended by the command. Among the reasons for this are:
    • The device has not been defined or has not been properly defined in the CONSOLxx member.
    • The device has been properly defined in the CONSOLxx member, but the system is unable to accept the device definition. This can be caused by defining devices that exceed the limit of 99 console definitions per sysplex.
  2. The command issuer is not authorized.
  3. The command requested that the system vary the hard-copy log offline, but the system has no current recording log.

If the unit is an output only device, it will be referenced as O-dev (for example, VARY O-dev,ONLINE).

In the message text:
HARDCOPY
A VARY HARDCPY,OFFLINE command was entered.
s
The subchannel set ID.
dddd
The number for the device specified on the command.

System action

The system rejects the command.

If VARY CN(xx),AUTH=value or VARY CN(nnnnnnnn),AUTH=value was entered, and the console identifier or name is incorrect or the issuer is not authorized, the system does not change the authority value for the specified console.

If a VARY CONSOLE command was entered for a console name that is a SMCS console or a subsystem console, the system issues this message to show the status.

If a VARY CONSOLE command was entered for device number dev or console name nnnnnnnn and the device is not active and not ready, the system issues this message to show the status.

If the unit is offline when an UNLOAD command is entered, then the system does not process the UNLOAD command. For example, if the UNLOAD 13D command is entered, when 13D is offline, the system issues message IEE313I as follows:

IEE313I 13D UNIT REF. INVALID

If a VARY device command (for example, VARY dev1-dev2,OFFLINE) is entered and each of the specified units is individually incorrect, the system displays dev1-dev2 in the message text.

Operator response

Do the following:
  • For case 1, enter the command again, specifying the correct unit name.
  • For case 2, enter the command from a console with master authority.
  • For case 3, none.

Also, check the SYSLOG of the system where the console should have been defined for the presence of message IEA195I; this indicates that one or more console definitions were not accepted. Issue the "D C,L" command and see whether the console mentioned in message IEE313I is listed as a validly-defined console.

Source

Consoles or MVS™ Device Allocation

Module

IEECB836, IEECB838, IEECB844, IEECB845, IEECB847, IEECB849, IEECB850, IEECB852, IEECB854, IEECB855, IEECB856, IEECB858, IEE5703D, IEE7203D, IEE8603D, IEECB903, IEEMB813, IEEVMNT2, IEFHBONL

Routing code

*

Descriptor code

5