INSERT_REF

Inserts a reference into a package

Syntax

Example

Syntax

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

Required Arguments

packageID: identifies the package.

Type:Numeric, Input

referenceType: specifies the type of the reference. Specify HTML or URL.

Type:Character, Input

reference: specifies the reference that is to be inserted.

Type:Character, Input

desc: describes the reference.

Type:Character, Input

nameValue

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. See the section about filtering for more information.

Type:Character, Input

rc: receives a return code.

Type:Numeric, Output

Example: Using INSERT_REF

The following example inserts links to newly created HTML files. The package is sent by 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="The SORT procedure  creates a variety of ODS generated
   html output." || "An example can  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, see Example: Publishing with the FTP Access Method.