NEWLINK



NEWLINK

     Creates a link to a file, group, account, or directory.

SYNTAX


NEWLINK [ LINK=] linkname
[;TO=] sourceobject
[ {;SYMBOLIC} ]

PARAMETERS


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.


OPERATION NOTES

     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.

USING SYMBOLIC LINKS

     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.

EXAMPLES

     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

ADDITIONAL INFORMATION

Commands:    PURGELINK, LISTFILE