ACTIVATE ISLINK

Read syntax diagramSkip visual syntax diagram ACTivate ISLink rdev 1 NODenodeidBUffersbuffercount2
Notes:
  • 1 You can specify a maximum of 16 real device numbers.
  • 2 The BUFFERS option may be specified but it is ignored.

Authorization

Privilege Class: B

Purpose

Use the ACTIVATE ISLINK command to identify a communication link to ISFC.

Operands

rdev
identifies one to sixteen real device numbers you want to use as a link.

When the first device is initialized for a new link, the ISLINK for that node is created automatically.

NODe nodeid
is the optional node (gateway) identifier for the ISFC link expected for each rdev. If not specified, it is determined by device initialization.

If a conflicting nodeid is specified for an already active device, an error message is issued.

BUffers buffercount
is ignored and included for compatibility only.

Usage Notes

  1. You may also need to define the real communication link to the system; see the RDEVICE Statement in z/VM®: CP Planning and Administration for more information.
  2. The system operator receives all informational and error messages, but not immediate command responses.
  3. You can improve throughput across your ISFC link by activating more than one device on the same link. Note, however, that FICON® subchannels on the same channel path share some hardware resources. In general you will observe better data transfer rates if subchannels on a given link are configured to use different channel paths.
  4. Avoid using different CHPID speeds in any one logical link, as that will cause the ISFC logical link to operate less efficiently.

Responses

Response 1:

Link rdev activated.
rdev
is the link address that has been activated.

Messages

  • HCP002E Invalid operand - operand
  • HCP003E Invalid option - command contains extra option(s) starting with option
  • HCP006E Invalid device type - rdev
  • HCP026E Operand missing or invalid
  • HCP040E Device rdev does not exist
  • HCP046E Device rdev offline
  • HCP049E Device rdev in use
  • HCP2702I Link linkname came up
  • HCP2704I Node nodeid added to collection
  • HCP2706I Link linkname activated by user userid
  • HCP2721E Link unit address rdev is a duplicate
  • HCP2722I The BUFFERS option is ignored for ACTIVATE ISLINK.
  • HCP2725E Inter-System Facility for Communication initialization failed: RC=return-code
  • HCP2745E Link device rdev rejected. Defined node nodeid1 conflicts with detected node nodeid2.
  • HCP2750I ISFC ACTIVATE is deferred for offline device devno.
  • HCP6005E Option BUFFERS is not supported by z/VM.