Chapter Contents |
Previous |
Next |
ITEMS |
OS/390 specifics: | all |
Syntax | |
Details | |
HTC File Format | |
Alternate Syntax for the DIR= and ITEM= Statements | |
LIST Statement | |
IMPORT Statement | |
EXPORT Statement | |
MERGE Statement | |
DELETE Statement | |
See Also |
Syntax |
PROC ITEMS NAME=<libref.>member; |
Details |
The contents of an itemstore are divided into directories, subdirectories, and topics. The directory tree structure emulates that of UNIX System Services, so that a given help topic is identified by a directory path (root_dir/sub_dir/item). This hierarchical structure allows the SAS help browser to supports HTML links between help topics.
The itemstores that SAS uses for HTML help can be written only by users with appropriate privilege. Though SAS Institute discourages rewrites of SAS help items, you can add items to the SAS help itemstores, and you can develop new itemstores of your own for any information that you wish to make available through the SAS help browser. For further information on writing your own HTML help, see Using User-Defined Help.
To access an itemstore, you must first allocate the library that contains the itemstore, unless the itemstore is a member of the WORK library. After you allocate the library, you issue the PROC ITEMS NAME=fileref statement to access the itemstore in SAS. Once the itemstore is available in SAS, you can use the LIST, IMPORT, EXPORT, MERGE, and DELETE statements to control itemstore contents. SAS applies all of these statements to the itemstore name in the last PROC ITEMS NAME= statement.
For information on the HTML tags that are supported
by the SAS help browser, see Using User-Defined Help
.
:::::<filename>.htm
Directories in the HTC file are identified by a line that begins with file colons and ends with a path specification:
:::::<dirname1>/<dirname2>/<filename>.htm
If the HTC file containing the previous entry was imported
into an itemstore with the IMPORT statement, the directory and subdirectory
would be created as needed, and the file would be placed in the specified
subdirectory. Any filename that lacks a path specification goes into the root
directory or into the directory specified by the DIR= option, if it is specified
in the IMPORT statement.
LIST DIR='usr' ITEM='mail'; LIST ITEM='usr/mail';
Note that a full path, starting with the directory just beneath the itemstore's root directory (with no initial forward slash) is required for access to anything except items in the root directory or to itemstores consisting of a single item.
Wildcards, using asterisks (*) as in UNIX, are not accepted
in itemstore paths. Nor can you specify more than one path (a file concatenation)
for each of the following statements.
Syntax |
LIST <options;> |
Syntax |
IMPORT FILEREF=fileref <options>; |
Syntax |
EXPORT FILEREF=fileref<options>; |
Syntax |
MERGE SOURCE=<libref.>member; |
A
libref is required in the MERGE statement. If the
two itemstores have directories with the same name and path, the contents
of the new directory replace the contents of the old directory. If you merge
into the root directory, the entire itemstore is replaced. If you merge a
new item into a directory, the new item is merged into the old directory.
If the old directory contains an item of the same name, the new item replaces
the old item.
The DELETE statement deletes all or part of the contents in an itemstore.
Syntax |
DELETE <options>; |
See Also |
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.