|********************************* TOP OF DATA ********************************|
| **** Dynamically activate/test I/O configuration definition**** |
| |
| Command: ACTIVATE Supported MVS Levels: ESAv5 |
| |
| Overview: The ACTIVATE command is used to activate a new I/O configuration |
| definition. |
| |
| Syntax: |
| ACTIVATE |,IODF=xx | |
| |,EDT=xx | |
| |,PROC=procname | |
| |,CFID=id | |
| |,RECOVER=SOURCE|TARGET | |
| |,ACTIOCDS=xx | |
| |,SOFT={VALIDATE|NOVALIDATE} | |
| |,TEST | |
| |,FORCE | |
| |,FORCE=DEVICE | |
| |,FORCE=CANDIDATE | |
| |,FORCE=(DEVICE,CANDIDATE) | |
| |,FORCE=(CANDIDATE,DEVICE) | |
| |
| Operands: ACTIVATE ***ESAv5*** |
| Activates or tests a new I/O configuation data set. |
| |
| IODF=xx |
| Use this operand to specify the suffix of the IODF with the |
| configuration definition. This is combined with IODFxx to |
| determine the actual data set definition. |
| |
| EDT=xx |
| Use this operand to identify the eligible devices table (EDT) |
| that will be built from the IODF. |
| |
| PROC=procname |
| Use this operand to identify the processor definition being |
| constructed. |
| |
| CFID=id |
| Use this operand to indicate the configuration ID. This is an |
| 8-byte name used to name the operating system definition in |
| the IODF. |
| |
| RECOVER=SOURCE|TARGET |
| Use this operand to indicate how a recover from a failure. |
| SOURCE means the previous I/O configuration should be retried. |
| TARGET means the new definition should be retried. |
| |
| ACTIOCDS=xx |
| Use this operand to specify the prefix to name the IOCDS to be |
| started by the system. |
| |
| SOFT={VALIDATE|NOVALIDATE} |
| Use this operand to create a change only in the software I/O |
| configuration. VALIDATE means the system checks if elements |
| begin deleted are available for deletion and if the HSA space |
| required for the change is available. |
| |
| TEST |
| Use this operand to determine if the configuation defintion is |
| valid. |
| |
| FORCE |
| Use this operand to manipulate hardware elements that can |
| effect other partitions in the configuration. For example, you |
| would use FORCE when running in LPAR mode and want to delete a |
| logical partition from a device candidate list. |
| |
| FORCE=DEVICE |
| Use this operand when you have Enterprise Systems Configuration |
| (ESCON) Multiple Image Facility (EMIF) and wish to remove an I/O |
| component from the definition. |
| |
| FORCE=CANDIDATE |
| Use this operand when you have Enterprise Systems Configuration |
| (ESCON) Multiple Image Facility (EMIF) and wish to keep all I/O |
| components but remove a partition from the access or candidate |
| list. This is not a recommended plan of action. |
| |
| FORCE=(DEVICE,CANDIDATE) |
| FORCE=(CANDIDATE,DEVICE) |
| Use this operand when you have Enterprise Systems Configuration |
| (ESCON) Multiple Image Facility (EMIF) and wish to delete I/O |
| components and remove a partition from the access or candidate |
| list. This is not a recommended plan of action. |
| |
| Examples: The example below will activate the CD IOCDS: |
| |
| ACTIVATE ACTIOCDS=CD |
| |
| The example below will test the PROCØØØ1 processor definition: |
| |
| ACTIVATE PROC=PROCØØØ1 |
| |
| The example below activates an IODF with the ØØ suffix: |
| |
| ACTIVATE IODF=Ø4 |
| |
|******************************* BOTTOM OF DATA *******************************|