The hierarchical file system element entry describes an element that exists in a distribution library or a UNIX file system. A hierarchical file system entry is created the first time you install a SYSMOD containing an MCS for a hierarchical file system element that does not yet have an entry in the CSI data set.
SMP/E records the function and service level of the hierarchical file system element in the entry. Once a hierarchical file system element entry exists, it is updated as subsequent SYSMODs affecting the hierarchical file system element are installed.
Table 1 shows the types of entries used for hierarchical file system elements. Some types of elements may be translated into several languages. In these cases, the entry type contains xxx, which represents the language used for the element. (If an element was not translated, the entry type does not contain any xxx value. Table 2 shows the xxx values and the languages they represent.
The name can contain 1–8 uppercase alphabetic, numeric, or national ($, #, @) characters.
The UCL operand is FMID(sysmod_id).
The SYSMOD ID must contain 7 uppercase alphabetic, numeric, or national ($, #, @) characters.
The SYSMOD ID must contain 7 uppercase alphabetic, numeric, or national ($, #, @) characters.
In LIST output, linknames are always enclosed in single apostrophes. If an apostrophe is part of a linkname, it is always shown as two consecutive apostrophes in LIST output.
The single apostrophes used to enclose a linkname (the delimiters) do not count as part of the 1023-character limit.
Double apostrophes count as two characters in the 1023-character limit.
POST is the default; the shell script is run after the element is copied to the directory.
The single apostrophes used to enclose a symbolic linkname (the delimiters) do not count as part of the 1023-character limit.
The single apostrophes used to enclose a symbolic pathname (the delimiters) do not count as part of the 1023-character limit.
SET BDY(TGT1) /* Set to requested zone. */.
LIST HFSESP /* List all generic HFS */
/* element entries (Spanish)*/.
SET BDY(TGT1) /* Set to requested zone. */.
LIST UNIX1(UNXEL1 /* List only these */
UNXEL2 /* three */
UNXEL3) /* entries. */.
PAGE nnnn - NOW SET TO zzzzzz ZONE nnnnnnn DATE mm/dd/yy TIME hh:mm:ss SMP/E 36.nn SMPLIST OUTPUT
TGT1 UNIX1 ENTRIES
NAME
UNXEL1 LASTUPD = UNXFUNC TYPE=ADD
LIBRARIES = DISTLIB=APOSIXL1 SYSLIB=UNXTGTL1
BINARY
FMID = UNXFUNC
RMID = UNXPTF1
SHSCRIPT = INSTAL01,PRE
LINK = 'linkname_1'
= 'linkname_2'
UNXEL2 LASTUPD = UNXFUNC TYPE=ADD
LIBRARIES = DISTLIB=APOSIXL2 SYSLIB=UNXTGTL2
TEXT
FMID = UNXFUNC
RMID = UNXFUNC
LINK = 'linkname_3'
= 'linkname_4'
SHSCRIPT = INSTAL02,POST
UNXEL3 LASTUPD = UNXFUNC TYPE=ADD
LIBRARIES = DISTLIB=APOSIXL2 SYSLIB=UNXTGTL2
TEXT
FMID = UNXFUNC
RMID = UNXPTF2
LINK = 'linkname_5'
'linkname_6'
SHSCRIPT = INSTAL03,PRE,POST
PARM = This_is_another_sample_character_string_specified_as_the_value_of_PARM.__It_is_a_maximum____
length_character_string_for_this_subentry.__I.e.,_it_is_300_characters_long.__The_string____
has_no_blanks_in_it.__If_you_see_something_that_looks_like_a_blank,_it's_not. The_previous_
2_characters_are_X'41'…
SET BDY(TGT1) /* Set to target zone. */.
LIST HFS /* List all hierarchical */
/* file system element */
/* entries */
FORFMID(HFS /* for the HFS FMIDSET */
HFSFUNC) /* and FMID HFSFUNC. */.
SET BDY(TGT1) /* Set to requested zone. */.
LIST HFS /* List all hierarchical */
/* file system element */
/* entries */
XREF /* and related SYSMODs. */.
PAGE nnnn - NOW SET TO zzzzzz ZONE nnnnnnn DATE mm/dd/yy TIME hh:mm:ss SMP/E 36.nn SMPLIST OUTPUT
TGT1 UNIX1 ENTRIES
NAME
UNXEL1 LASTUPD = UNXFUNC TYPE=ADD
LIBRARIES = DISTLIB=APOSIXL1 SYSLIB=UNXTGTL1
BINARY
FMID = UNXFUNC
RMID = UNXPTF1
LINK = 'linkname_1'
= 'linkname_2'
SHSCRIPT = INSTAL01,PRE
SYSMOD HISTORY = SYSMOD TYPE DATE MCS --STATUS--
UNXFUNC FUNCTION 07.100 UNX APP ACC
UNXPTF1 PTF 07.120 UNX APP ACC
UNXEL2 LASTUPD = UNXFUNC TYPE=ADD
LIBRARIES = DISTLIB=APOSIXL2 SYSLIB=UNXTGTL2
TEXT
FMID = UNXFUNC
RMID = UNXFUNC
LINK = 'linkname_3'
= 'linkname_4'
SHSCRIPT = INSTAL02,POST
SYSMOD HISTORY = SYSMOD TYPE DATE MCS --STATUS--
UNXFUNC FUNCTION 07.100 UNX APP ACC
SET BDY(TGT1) /* Set to requested zone. */.
LIST SHELLSCR /* List all UNIX shell */
/* script element entries */.
Figure 3 shows an example of the LIST output
for SHELLSCR element entries. PAGE nnnn - NOW SET TO TARGET ZONE zzzzzz DATE mm/dd/yy TIME hh:mm:ss SMP/E 36.nn SMPLIST OUTPUT
TGT1 SHELLSCR ENTRIES
NAME
INSTAL01 LASTUPD = FUNC001 TYPE=ADD
LIBRARIES = DISTLIB=HFSDLIB SYSLIB=UNXTGTL1
TEXT
FMID = FUNC001
RMID = FUNC001
INSTAL02 LASTUPD = FUNC002 TYPE=UPD
LIBRARIES = DISTLIB=HFSDLIB SYSLIB=UNXTGTL1
TEXT
FMID = FUNC002
RMID = FUNC002
INSTAL03 LASTUPD = FUNC001 TYPE=ADD
LIBRARIES = DISTLIB=HFSDLIB SYSLIB=UNXTGTL1
TEXT
FMID = FUNC001
RMID = FUNC001
SET BDY(TGT1) /* Set to requested zone. */.
UNLOAD OS21 /* Unload all OS21 element entries. */.
SET BDY(TGT1) /* Set to requested zone. */.
UNLOAD OS21(OS2EL1 /* Unload only these */
OS2EL2 /* three */
OS2EL3) /* entries. */.
UCLIN .
REP OS21 ( OS2EL1 )
LASTUPD ( OS2FUNC )
LASTUPDTYPE ( ADD )
DISTLIB ( OS2DSTL1 )
SYSLIB ( OS2TGTL1 )
FMID ( OS2FUNC )
RMID ( OS2PTF1 )
LINK ( 'linkname_1'
'linkname_2' )
SHSCRIPT ( INST0S2,POST )
.
REP OS21 ( OS2EL2 )
LASTUPD ( OS2FUNC )
LASTUPDTYPE ( ADD )
DISTLIB ( OS2DSTL2 )
SYSLIB ( OS2TGTL2 )
FMID ( OS2FUNC )
RMID ( OS2FUNC )
LINK ( 'linkname_3'
'linkname_4' )
SHSCRIPT ( INST0S2,POST )
.
REP OS21 ( OS2EL3 )
LASTUPD ( OS2FUNC )
LASTUPDTYPE ( ADD )
DISTLIB ( APOSIXL2 )
SYSLIB ( OS2TGTL2 )
TEXT
FMID ( OS2FUNC )
RMID ( OS2PTF2 )
LINK ( 'linkname_5'
'linkname_6' )
PARM ( This_is_another_sample_character_string_spec
ified_as_the_value_of_PARM.__It_is_a_maximum
____length_character_string_for_this_subentr
y.__I.e.,_it_is_300_characters_long.__The_st
ring____has_no_blanks_in_it.__If_you_see_som
ething_that_looks_like_a_blank,_it's_not. T
he_previous_2_characters_are_X'41'…
)
.
ENDUCL.
SET BDY(TGT1) /* Set to target zone. */.
UNLOAD OS21 /* Unload all OS21 element entries */
FORFMID(OS21 /* for the OS21 FMIDSET */
OS2FUNC) /* and FMID OS2FUNC. */.
Otherwise, there is not enough information in the entry to process the element. If any of these subentries are missing, SMP/E does not make the requested UCL updates to the entry, and the entry remains as it was before the UCL command.
The following examples are provided to help you use the hierarchical file system element entries.