Contents Publish Package Interface Previous Next

INSERT_REF

This CALL routine inserts a reference into a package.

Syntax

CALL INSERT_REF(packageId, referenceType, reference, desc, nameValue, rc);

packageID
Numeric, input.
Identifies the package.

referenceType
Character, input.
Specifies the type of the reference. Specify HTML or URL.

reference
Character, input.
Specifies the reference that is to be inserted.

desc
Character, input.
Describes the reference.

nameValue
Character, Input.
Identifies a list of one or more space-separated name/value pairs, each in one of the following forms:

  • name
  • name=value
  • name="value"
  • name="single value with spaces"
  • name=(value)
  • name=("value")
  • name=(value1, "value 2",... valueN)

Name/value pairs are site-specific; they are used for the purpose of filtering.

rc
Numeric, output.
Receives a return code.

Examples

The following example inserts links to newly created HTML files. The package is sent using the EMAIL transport so that subscribers receive embedded links within their e-mail messages.

filename myfram ftp 'odsftpf.htm';

filename mybody ftp 'odsftpb.htm';

filename mypage ftp 'odsftpp.htm';

filename mycont ftp 'odsftpc.htm';

ods listing close;
ods html frame=myfram body=mybody page=mypage contents=mycont;

/* insert SAS statements here to develop ODS output*/

ods html close;

desc="Proc sort creates a variety of ODS generated html output." || 
     "An example may be viewed at :";
call insert_ref(packageId, "HTML", "http://alpair01.unx.com/odsftpf.htm", desc, 
                "", rc);
if rc ne 0 then do;
   msg = sysmsg();
   put msg;
end;
else
  put 'Insert reference OK';

For another example, refer to Example: Publishing with the FTP Access Method.

See Also

Contents Publish Package Interface Previous Next