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.



This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments