INSERT_REF

Arguments

packageID

identifies the package.

Type:	Numeric
Direction:	Input

referenceType

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

Type:	Character
Direction:	Input

reference

specifies the reference that is to be inserted.

Type:	Character
Direction:	Input

desc

describes the reference.

Type:	Character
Direction:	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 filtering.

Type:	Character
Direction:	Input

rc

receives a return code.

Type:	Numeric
Direction:	Output

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.

Copyright © 2008 by SAS Institute Inc., Cary, NC, USA. All rights reserved.