SAS Institute. The Power to Know

SAS(R) 9.2 Publishing Framework: Developer's Guide

Previous Page | Next Page

Publishing Packages

INSERT_PACKAGE



Inserts a package into another package
Syntax
Arguments
Details

Syntax

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

Arguments

packageId

identifies the package.

Type: Numeric
Direction: Input
insertPackageId

identifies the package that will be nested in the package identified by packageID.

Type: Numeric
Direction: Input
rc

receives a return code.

Type: Numeric
Direction: Output
properties

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

  • NESTED_NAME

Type: Character
Direction: 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:   The NESTED_NAME property is valid only when publishing to the WebDAV-compliant server transport.  [cautionend]

Type: Character
Direction: 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_BEGIN CALL routine.

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);

Previous Page | Next Page | Top of Page