INSERT_PACKAGE

Inserts a package into another package

Syntax

CALL INSERT_PACKAGE(packageId, insertPackageId, rc
<, properties, propValue1, ...propValueN> );

Required Arguments

packageId
identifies the package.
Type:Numeric, Input
insertPackageId
identifies the package that will be nested in the package identified by packageID.
Type:Numeric, Input
rc
receives a return code.
Type:Numeric, Output

Optional Arguments

properties
identifies a comma-separated list of optional property names. At present, only one property is supported:
  • NESTED_NAME
Type:Character, Input
propValue1, …propValueN
specifies one value for each specified property name. The order of the property values must match the order of the property names in the properties parameter. Valid property values are defined as follows:
NESTED_NAME indicates the name of the nested directory to create for the storage of the nested package. If you do not specify a value for this property, then a name is generated automatically. Note that the NESTED_NAME property is valid only when publishing to the WebDAV-compliant server transport.
Type:Character, Input

Details

Description and name/value parameters are not allowed on this CALL routine. Instead, this CALL routine uses the description and name/value parameters that are specified in the PACKAGE_BEGINCALL routine.

Example: Using INSERT_PACKAGE

The following example initializes two packages (PACKAGEID and DSPID). All data sets are inserted into the package that is identified by DSPID. The package that is identified by DSPID is nested within the main package that is identified by PACKAGEID.
CALL PACKAGE_BEGIN(packageId,
   "Main package", '', '', rc);

CALL PACKAGE_BEGIN(dsPid, "Package
   of just data sets.", '', '', rc);

libname = 'sasuser';
memname = 'payroll';
desc = 'Monthly payroll data.';
CALL INSERT_DATASET(dsPid, libname,
   memname, desc, '', rc);

libname = 'sasuser';
memname = 'employees';
desc = 'Employee data.';
CALL INSERT_DATASET(dsPid, libname,
   memname, desc,"", rc);

/* nest data set package in main package */
CALL INSERT_PACKAGE(packageId, dsPid, rc);