RCCUALOC

RCCUALOC creates, allocates, or frees commonly used data sets and associated DD names used by other API functions.

Purpose

Note: 'USERID' is the user ID of the mainframe system from which the RCCUALOC function is being invoked.

When you run RCCUALOC, you create the following PDS data sets:

  • ‘USERID'.TSC.CMD
  • ‘USERID'.TSC.JCL
  • ‘USERID'.TSC.APILOG
  • ‘USERID'.TSC.APILOG2

The following DD names will be allocated or freed:

  • Files internal to the implementation of the API:
    • RCCIN for ‘USERID'.TSC.CMD(APIIN)
    • RCCMAP for ‘USERID'.TSC.CMD(APIMAP)
    • RCCPARMS for ‘USERID'.TSC.CMD(APICCCMD)
    • SECF for ‘USERID'.TSC.CMD(SECF)
  • Files the user or user REXX™ programs can access (view and read):
    • RCCOUT for ‘USERID'.TSC.CMD(APIOUT)
    • RCCERR for ‘USERID'.TSC.CMD(APIERR)
    • RCCLOG1 for ‘USERID'.TSC.APILOG
    • RCCLOG2 for ‘USERID'.TSC.APILOG2
    • STDOUT, STDERR, RCCLOG are allocated to SYSOUT(A)

Syntax

RCCUALOC(function)

Arguments

You can specify the following for the function argument when you run the RCCUALOC function:

CREATE
The data sets are created and allocated.
Note: The CREATE function should be performed only once for each 'USERID'.
ALLOCATE
Allocate the data sets.
FREE
Free (deallocate) the data sets.

Result

The following table lists the return and reason codes that result from running the RCCUALOC function; it also provides a description of the meaning of the codes.

Table 1. Result of running the RCCUALOC function
Return code Reason code Description
0 600 Processing successful.
8 612 Invalid argument value.
614 Distributed command failure.
615 Allocation for required data sets failure.
616 Improper number of arguments.
12 698 Internal error.
699 Internal error.

Example

PARSE Value RCCUALOC(‘CREATE') With rccret rccrsn rccmsg