INSERT_PACKAGE

Inserts a package into another package.

Syntax

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

packageId

Numeric, input.
Identifies the package.

insertPackageId

Numeric, input.
Identifies the package that will be nested in the package identified by packageID.

rc

Numeric, output.
Receives a return code.

properties

Character, input.
Identifies a comma-separated list of optional property names. At present, only one property is supported:

• NESTED_NAME

propValue1, ...propValueN

Character, input
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

Character string 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, a name is generated automatically.

Note: The NESTED_NAME property is valid only when publishing to the WebDAV-compliant server transport.

Details

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

The following example initializes two packages (PACKAGEID and DSPID). All data sets are inserted into the package identified by DSPID. The package identified by DSPID is nested within the main package 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);

See Also

• PACKAGE_BEGIN
• PACKAGE_PUBLISH