Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001
Creates a link to a file, group, account, or directory.
NEWLINK [ LINK=] linkname
[;TO=] sourceobject
[ {;SYMBOLIC} ]
linkname The name of the link you are creating, in MPE or
HFS syntax. This is a required parameter that
must conform to the following restrictions:
o you may not specify wildcards in the linkname
o you may not use a file equation in place of
linkname
o linkname may not name a system defined file
(such as $NULL)
sourceobject The file, group, account or directory that linkname
points to. This is a required parameter that must
conform to the same restrictions as linkname.
The sourceobject does not need to exist when
creating symbolic links.
Security provisions of sourceobject do not affect
the creation of symbolic link(s) to sourceobject.
SYMBOLIC Creates a symbolic link. This is the default.
Use the NEWLINK command to create a link to a file, group,
account, or directory. The NEWLINK command fails when linkname
already exists.
o To list links, enter LISTFILE ,7.
o To purge a link, use the PURGELINK command.
You may issue the NEWLINK command from a session, job, program,
or in BREAK. NEWLINK requires Save Files (SF) capability, Create
Directory entry (CD) and Traverse Directory (TD) permissions.
The CI always resolves symbolic links to their sourceobject
except when the link is the filename component and it is used
in any of the following commands: NEWLINK, PURGELINK, PURGEACCT,
PURGEGROUP, REPORT, STORE, RESTORE, LISTFILE, LISTACCT, LISTGROUP,
CHGROUP, NEWGROUP, and NEWACCT.
The following example creates a link called LINK1 in the current
working directory that points to a file named REALFILE:
:NEWLINK LINK1,REALFILE
Then, when you issue the PRINT command for LINK1, as shown below,
MPE prints REALFILE:
:PRINT LINK1
When you purge LINK1, MPE resolves the link and purges REALFILE:
:PURGE LINK1
The next example creates a link called /OFFICIAL which points to
the SYS account:
:NEWLINK /OFFICIAL,/SYS
When you reference a file using OFFICIAL in its pathname, MPE
follows the link and looks in the SYS account for the specified
file. For example, when you enter the command below, MPE
executes CI.PUB.SYS:
:RUN CI.PUB.OFFICAL
Commands: PURGELINK, LISTFILE Back to Main Index