Delete Network File (DLTNETF)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Delete Network File (DLTNETF) command deletes a file or files from a user's queue of arrived network files. A user with security officer authority can delete files sent to any user. A user other than the security officer can delete only those files that are sent to him or to his group profile.

Top

Parameters

Keyword Description Choices Notes
FILE File Character value Required, Positional 1
MBR Member Character value, *ONLY, *ALL Optional, Positional 2
NBR File number Integer, *LAST, *ONLY, *ALL Optional, Positional 3
USER User Name, *CURRENT Optional
Top

File (FILE)

Specifies the name of the network file that has one or more members to be deleted.

This is a required parameter.

Top

Member (MBR)

Specifies the name of the file member that is deleted.

*ONLY
Only one file member is deleted.
*ALL
All file members available for this file are deleted. If *ALL is specified here, *ALL must also be specified on the File number prompt (NBR parameter).
member-name
Specify the name of the file member that is deleted. A file member name cannot be specified if the file is a save file.
Top

File number (NBR)

Specifies the number of the network file member that is deleted. This number is used to identify the member deleted when there is more than one member of the same name in the file.

*LAST
The last copy of the network file member identified on the File prompt (FILE parameter) and Member prompt (MBR parameter) is deleted. The last file member is determined as the last member to arrive at the user's system.

Note: The file member that arrived last at the user's system may not have been the last one sent by the sending user. The network does not guarantee the arrival sequence of separately sent files.

*ONLY
Only one file member of the specified file name is deleted. If there is more than one member of the specified name available, an escape message is sent, and the command is not run.
*ALL
All members that are identified on the File prompt (FILE parameter) and Member prompt (MBR parameter) are deleted. If a member name is specified, all members of that name are deleted. If *ALL is specified for the MBR parameter, all members of the file are deleted.
number
Specify the network file number of the file member that is deleted.
Top

User (USER)

Specifies the user to whom the deleted files were sent.

*CURRENT
The files sent to the current user are deleted.
user-name
Specify the name of the user to whom the files were sent. A user with security officer authority can delete files sent to any user. Users other than the security officer can delete only those files that are sent to them or to their group profile.
Top

Examples

Example 1: Deleting a Single Member

DLTNETF   FILE(APPOINTMNT)  MBR(FRIDAY)

This command deletes member FRIDAY of file APPOINTMNT.

Example 2: Deleting a File

DLTNETF   FILE(SCHEDULE)  USER(NETUSER1)  NBR(708926)

This command deletes file SCHEDULE, number&rbl.708926, from the network files for user NETUSER1. This command is run only by NETUSER1, a member of the NETUSER1 group, or a user with security officer authority.

Example 3: Deleting All Members

DLTNETF   FILE(OLDINFO)  MBR(*ALL)  NBR(*ALL)

This command deletes all available members for file OLDINFO, including all duplicated named members.

Top

Error messages

*ESCAPE Messages

CPF2204
User profile &1 not found.
CPF8060
No files compare to the specified selection.
CPF8063
Cannot assign necessary resource.
CPF8070
Not allowed to process files for user &1.
CPF8077
More than one file with same name found. See previously displayed messages.
CPF8081
File &5 member &6 number &7 already processed.
CPF8082
Cannot get network file &5 member &6 number &7.
CPF8083
No network files deleted.
CPF9005
System resource required to complete this request not available.
CPF9006
User not enrolled in system distribution directory.
CPF9830
Cannot assign library &1.
CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.
CPF9847
Error occurred while closing file &1 in library &2.
Top