This sample uses HWIREST API to:

• List CPCs, filtered by the CPC name provided, in order to retrieve the URI and target name associated with that CPC
• List the LPARs on that CPC, filtered by the LPAR name provided, in order to retrieve the URI and target name associated with that LPAR
• Query the status of the LPAR to ensure it's in the required 'not-activated' status
• Query the next activation profile for the LPAR so it can be re-used as input for the LPAR Activate
• Activate the LPAR and POLL the job-uri for the result of the operation
• Re-query the current status of the LPAR

1. Ensure your z/OS user ID has the specified access to the following FACILITY Class Profiles

   • READ access to HWI.TARGET.netid.nau
   • CONTROL HWI.TARGET.netid.nau.imagename

   where netid.nau represents the 3-to-17 character SNA name of the particular CPC and imagename represents the 1-to-8 character LPAR name that will be used as input

2. Create the following data sets for the application

   • hlq.HWIREST.CPP - DSORG=PO,RECFM=VB,LRECL=255 - used to store the C++ source files
   • hlq.HWIREST.H - DSORG=PO,RECFM=VB,LRECL=255 - used to store the header files
   • hlq.HWIREST.LISTCPP - DSORG=PO,RECFM=VBA,LRECL=137 - used to store listings
   • hlq.HWIREST.OBJ - DSORG=PO,RECFM=FB,LRECL=80 - used to store objects
   • hlq.HWIREST.JCL - DSORG=PO,RECFM=FB,LRECL=80 - used to hold the JCLs
   • hlq.HWIREST.PDSE.LOAD - DSORG=PO,RECFM=U - used to store final object after bind

3. Store the .cpp files into hlq.HWIREST.CPP data sets

4. Store the .h files into hlq.HWIREST.H data sets

5. Store the hwirstcx.jcl into hlq.HWIREST.JCL and customize for your environment

   • this JCL will compile and bind the various source files to create the executable, HWIRSTC1
   • replace hlq., update SYSAFF, and possibly update JCLLIB ORDER value

6. Submit job HWIRSTCX to generate the HWIRSTC1 executable

7. Store the hwirstc1.jcl into hlq.HWIREST.JCL and customize for your environment

   • this JCL will be used to execute the application
   • replace the hlq., update SYSAFF, and update the CPCname and LPARname with the desired targets

8. Submit job HWIRSTC1 to execute the application

Syntax:

 HWIRSTC1 CPCname LPARname

where:

• CPCname is the name of the CPC that is associated wth the target LPAR , required
• LPARname is the name of the LPAR you wish to activate, required

NOTE: runtime option POSIX(ON) is required

sample invocation using BATCH:

jcl/hwirstcx.jcl

HWIRST1  EXEC PGM=HWIRSTC1,
    PARM='POSIX(ON),MSGFILE(SYSOUT) / CPC1 LP1'

sample output:

SUCCESS: Parser initialized.
argv passed in: CPC1 length 4
argv passed in: LP1 length 3
*>>
*>>REQUEST:
GET /api/cpcs?name=CPC1
*>>
*>>REQUEST was successful: 200
* >responseBody:'{"cpcs":[{"name":"CPC1","se-version":"2.15.0","location":"local","object-uri":"/api/cpcs/ffff-999-333-888","target-name":"IBM390PS.CPC1"}]}'
*>>
CPCuri:/api/cpcs/ffff-999-333-888
CPCtargetName:IBM390PS.CPC1
*>>
*>>REQUEST:
GET /api/cpcs/ffff-999-333-888/logical-partitions?name=LP1
* >targetName:'IBM390PS.CPC1'
*>>
*>>REQUEST was successful: 200
* >responseBody:'{"logical-partitions":[{"name":"LP1","request-origin":false,"object-uri":"/api/logical-partitions/11111-cccc-aaaa","target-name":"IBM390PS.CPC1.LP1","status":"not-activated"}]}'
*>>
LPARuri:/api/logical-partitions/11111-cccc-aaaa
LPARtargetName:IBM390PS.CPC1.LP1
*>>
*>>REQUEST:
GET /api/logical-partitions/11111-cccc-aaaa?properties=status&cached-acceptable=true
* >targetName:'IBM390PS.CPC1.LP1'
*>>
*>>REQUEST was successful: 200
* >responseBody:'{"status":"not-activated"}'
*>>
LPAR status is not-activated
*>>
*>>REQUEST:
GET /api/logical-partitions/11111-cccc-aaaa?properties=next-activation-profile-name&cached-acceptable=true
* >targetName:'IBM390PS.CPC1.LP1'
*>>
*>>REQUEST was successful: 200
* >responseBody:'{"next-activation-profile-name":"LP1"}'
*>>
LPAR next-activation-profile-name is LP1
*>>
*>>REQUEST:
POST /api/logical-partitions/11111-cccc-aaaa/operations/activate
* >targetName:'IBM390PS.CPC1.LP1'
* >requestBody:'{"activation-profile-name":"LP1","force":true}'
*>>
*>>REQUEST was successful: 202
* >responseBody:'{"job-uri":"/api/jobs/99999-4444-6666"}'
*>>
jobUri:/api/jobs/99999-4444-6666
*>>starting polling at Wed Apr  7 23:04:17 2021
elapsed time for activate LPAR completion is 22.00 seconds
*>>
*>>REQUEST:
GET /api/logical-partitions/11111-cccc-aaaa?properties=status&cached-acceptable=true
* >targetName:'IBM390PS.CPC1.LP1'
*>>
*>>REQUEST was successful: 200
* >responseBody:'{"status":"not-operating"}'
*>>
LPAR status is not-operating
SUCCESS: Parser work area freed.