Using the Delete function - changing PL/I application programs
When the application program no longer needs AR/CTL to manage the virtual storage area, you can use the Delete function as shown in the following figure. This function removes the definition of the virtual storage area, and AR/CTL no longer manages the area.
Delete function of the ARCSPVS API
/* D E L E T E _ A R E A _ 1 */
/***************************************************************/
DELETE_AREA_1:
PROC;
WS_LABEL = 'DELETE_AREA_1';
SPVS_IDENTIFIER = '$ARCSPVS';
SPVS_FUNCTION = 'DELETE';
SPVS_NAME = 'P1BUBBG_1';
PARM_COUNT = 1;
CALL ARCSPVS
(PARM_COUNT,
ARCSPVS_PARAMETER_BLOCK);
DELETE_AREA_1_EXIT:
END DELETE_AREA_1;
For the Delete function, set the parameter values as described in the following table.
$ARCSPVS parameter block fields for the Delete function
Parameter | Refresh function value |
|---|---|
Identifier | $ARCSPVS |
Function | DELETE |
Name | must identify a previously defined virtual storage area |
Return Code | ALL ZEROES The application program can check the Return Code parameter after the ARCSPVS API returns control to the program. If the value is not zero, the requested operation has failed. |
Beginning Address | ignored |
Delimiter | ignored |
Refresh Interval | ignored |
Save Interval | ignored |
Reserved | LOW-VALUES This area is required and might be used by AR/CTL. |