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.sys.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

• PACKAGE_BEGIN
• PACKAGE_PUBLISH