EXTERNAL

Authorization

Privilege Class: G

Purpose

Use EXTERNAL to simulate external-interrupt-pending to your virtual machine.

Operands

KEY

identifies the operator external interrupt key. KEY is the default.

INTerval

identifies the interval timer at location 80. You can specify INTERVAL only if the 370 Accommodation facility is active. Use the CP SET 370ACCOM ON command to activate the 370 Accommodation facility. When you specify INTERVAL, an interval timer interrupt is made pending.

CALL

identifies an external call SIGP signal from the specified virtual processor address and is accepted only when no external call is already pending.

EMERGency

identifies an emergency signal from the specified virtual processor address.

MALFunction

identifies a malfunction alert signal from the specified virtual processor address.

cpuaddr

identifies a virtual processor address from 0 to 3F (hexadecimal).

code

identifies an external interrupt code.

CR0 bitno

indicates that a mask bit in CR0 (control register 0) is to be applied to this interrupt. The operand bitno is the bit number in CR0 that masks this interrupt; it is a decimal number from 16 to 31. For an ESA/390 virtual machine, specifying 16-31 refers to the masks in bits 16-31 of control register 0. For a z/Architecture® mode virtual machine, specifying 16-31 refers to the corresponding masks that are in bits 48-63 of control register 0.

CMD command

indicates that a CP command is to be issued when the interrupt is reflected. You must enter the command at the end of the command line; characters following CMD are interpreted as the CP command.

Usage Notes

1. The BEGIN command is not required after you enter the EXTERNAL command.
2. Since there is no virtual processor address argument for code:
   1. EXTERNAL 1200 cannot be an alternative syntax for EXTERNAL MALFUNCTION cpuaddr
   2. EXTERNAL 1201 cannot be an alternative syntax for EXTERNAL EMERGENCY cpuaddr
   3. EXTERNAL 1202 cannot be an alternative syntax for EXTERNAL CALL cpuaddr.
      Note: This is true because of the architectural requirement that only 1 external call can be pending for a virtual processor at any one time.
   A bit in CR0 can be specified to mask this interrupt. Since the interrupt code does not imply a bit in CR0:
   1. EXTERNAL 40 is not an alternative syntax for EXTERNAL KEY.
   2. EXTERNAL 80 is not an alternative syntax for EXTERNAL INTERVAL.
      Note: This is true because of the architectural requirement that only 1 interval timer interrupt can be pending for a virtual processor at any one time.
3. You can specify a CP command that you want to be processed after the interrupt is reflected to your virtual machine. Use this in system testing.

Messages

• HCP002E Invalid operand - operand
• HCP003E Invalid option - {option|command contains extra option(s) starting with option}
• HCP026E Operand missing or invalid