Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

ftshwp

&pagelevel(3)&pagelevel

Note on usage

Function: Display FT profiles

User group: FTAC user and FTAC administrator

Functional description

ftshwp stands for "show profile" and allows you to obtain information about FT profiles. In short form, it displays the names of the selected FT profiles, as well as the following information:

  • whether or not the FT profile is privileged: asterisk (*) before the profile name

  • whether or not the transfer admission is disabled: exclamation mark (!) before the profile name.

You can only obtain information about your own FT profiles.

As the ADM administrator, you may also obtain information about ADM profiles (i.e. FT profiles with the property "access to remote administration server").

As the FTAC administrator, you may obtain information about all FT profiles in the system.

Format

ftshwp -h |

[ <profile name 1..8> | @s ]
[ -s=[<transfer admission> | @a | @n]

[,<user ID> | @a | @adm] ]

[ -l ][ -csv ]

Description

-h

Displays the command syntax on the screen. Entries after the -h are ignored.

profile name | @s

Is the name of the FT profile you wish to see.

@s for profile name

Provides information on the standard admission profile for the user ID if this has been set up. Otherwise you see a corresponding message.

profile name not specified

Profile name is not used as a criterion for selecting the FT profile to be displayed. If you do not specify the profile with -s (see below), FTAC will display information on all of your FT profiles.

-s=[transfer admission | @a | @n][,user ID | @a]

-s is used to specify criteria for selecting the FT profiles to be displayed.

If you wish to view standard admission profile, you can only specify @n or @a.

Transfer admission

Is the transfer admission of the FT profile to be displayed. A binary transfer admission must be specified in hexadecimal format, see section “Entering commands”.

@a for transfer admission

Displays information either on the FT profile specified with profile name (see above) or (if no profile name was specified) on all of your FT profiles.

As the FTAC administrator, you can specify @a if you want to obtain information on FT profiles belonging to other login names, since even you should not know the transfer admission.

@n for transfer admission

displays information on FT profiles that do not have a defined transfer admission.

As the FTAC administrator, you can specify @n if you want to obtain information on FT profiles belonging to other login names which do not have a defined transfer admission.

transfer admission not specified

causes FTAC to query the transfer admission on the screen after the command is entered. Your entry is not displayed to prevent unauthorized persons from seeing the transfer admission. If you just press <ENTER>, this has the same effect as specifying @a.

,user ID

must be your own login name if you are a normal user.

As the FTAC administrator, you can specify any login name here.

@a for user ID

allows you to display only profiles belonging to your own login name.

As the FTAC administrator, you can obtain information on the FT profiles of all login names.

As the ADM administrator, you can obtain information on the own FT profiles and the ADM profiles.

@adm for user ID

For the FTAC and ADM administrator only.

As the FTAC or ADM administrator, you obtain information on ADM profiles.

user ID not specified

displays only profiles belonging to the user's own login name, regardless of who issues the command.

-s not specified

if no profile name is specified, displays all the FT profiles belonging to the login name under which the ftshwp command is issued. Otherwise, displays information on the FT profile with the specified name.

-l

displays the contents of the selected FT profiles.

In long form, the entire contents of the selected FT profiles are displayed. The USER-ADM parameter contains the following information:

  • the login name for which an admission profile is valid or if it is an ADM profile

  • whether or not it is valid for a specific password of the login name

  • whether or not it is valid for any password of the login name

  • whether or not it has an undefined password and is thus disabled.

Please note that ADM profiles always are indicated by the value *ADM under the USER-ADM parameter.

USER-ADM=

Meaning

(user ID,,OWN)

Profile is valid for all passwords of the login name.

(user ID,,YES)

The profile is valid only for a specific password of the login name
(specified in -ua=user ID, password with an ftcrep or ftmodp command).
The profile is deactivated (not disabled) if the password is changed.
You can activate it again, for example, by resetting the password.

(user ID,,
NOT-SPECIFIED)

The FTAC administrator created or modified the FT profile knowing
only the login name. As a result, the profile was disabled. You must
enable the profile with ftmodp and the -v=y parameter.


If an FT profile is disabled, the TRANS-ADM parameter indicates the reasons why the profile was disabled. The following table shows the possible parameter values, as well as their meanings:


TRANS-ADM=

Possible cause and action

NOT-SPECIFIED

The FTAC administrator created the FT profile without transfer
admission, or the FTAC user did not specify transfer admission.
Measure: specify transfer admission

DUPLICATED

An attempt was made to create an FT profile with the same transfer
admission.
Measure: specify new transfer admission

LOCKED (by_adm)

The FTAC administrator modified the FT profile by login name only.
The transfer admission remained unchanged but was disabled.
Measure: enable the profile using the ftmodp command and the -v=y
parameter

LOCKED (by_import)

The FT profile was created using the ftimpe command. The transfer
admission remains unchanged, but is marked as disabled. Measure:
enable the profile using the ftmodp command and the -v=y parameter.

LOCKED (by_user)

The FTAC user disabled his/her own FT profile. Measure: enable
profile using the ftmodp command and the -v=y parameter.

EXPIRED

The time up to which the transfer admission can be used has expired.
Measure: enable profile using the ftmodp command and the -d
parameter, by removing the temporal restriction using the -d entry and
defining a new time span with -d=date.


ftshwp does not provide a means of displaying a transfer admission. If you have forgotten a transfer admission, you have to define a new one using ftmodp.

-l not specified

displays only the names of your FT profiles. Markings also indicate whether or not an FT profile is privileged (*) and whether or not it is disabled (!).

-csv

You can use -csv to specify that the FT profiles are to be output in the CSV format. The values in the output are separated by semicolons. If -csv is specified, output is always in long form (analogous to -l) regardless of whether or not -l has also been specified.

-csv not specified

The FT profiles are output in the standard format, i.e. in abbreviated form if -l is not specified and in detailed form if -l is specified.

Examples

  1. Scrooge McDuck wishes to see the FT profile goldmrep under his login name. This profile was created in the command ftcrep (see Examples).

    ftshwp goldmrep -l

    The output is as follows:

    Unix systems:

    goldmrep 
 EXP-DATE    = 20173112
 TRANS-DIR   = FROM
 PARTNER     = goldmine
 FILE-NAME   = monthlyreport_goldmine01
 WRITE       = REPLACE-FILE
 USER-ADM    = (scrooge,,OWN)
 FT-FUNCTION = (TRANSFER-FILE, FILE-PROCESSING)
 SUCC-PROC   = 'lpr monthlyreport_goldmine01'
 FAIL-PROC   = NONE
 DATA-ENC    = YES
 FILE-AT-ENC = YES
 LAST-MODIF  = 2016-03-27 14:55:23

    Windows systems:

    goldmrep

      EXP-DATE      = 20173112

      TRANS-DIR     = FROM

      PARTNER       = goldmine
      FILE-NAME     = monthlyreport_goldmine01

      WRITE         = REPLACE-FILE

      USER-ADM      = (scrooge,,OWN)
      FT-FUNCTION = (TRANSFER-FILE, FILE-PROCESSING)

      SUCC-PROC     = 'lpr monthlyreport_goldmine01'

      FAIL-PROC     = NONE
      DATA-ENC      = YES

      FILE-AT-ENC = YES

      LAST-MODIF    = 2016-03-27 14:55:23

    The timestamp of the most recent change is shown under LAST-MODIF.

    If you specify ftmodp goldmrep without any further parameters, you can force the timestamp to be updated without changing the profile properties.

  2. Scrooge McDuck wishes to see the standard FT profile:

    ftshwp @s -l
*STD
 TRANS-ADM   = (NOT-SPECIFIED)

    WRITE       = NEW-FILE
USER-ADM    = (scrooge,,OWN)
FT-FUNCTION = (TRANSFER-FILE)
LAST-MODIF  = 2016-03-22 16:06:55

  3. You are an FTAC administrator and want to view all the standard admission profiles on

    your system.

    ftshwp @s -s=@n,@a -l

    Output takes the following form:

    *STD
 TRANS-ADM   = (NOT-SPECIFIED)
 USER-ADM    = (john,,OWN)
 FT-FUNCTION = (TRANSFER-FILE, MODIFY-FILE-ATTRIBUTES, READ-FILE-
DIRECTORY)
 LAST-MODIF  = 2016-03-23 17:12:25
*STD
 TRANS-ADM   = (NOT-SPECIFIED)
 WRITE       = NEW-FILE
 USER-ADM    = (dagobert,,OWN)
 FT-FUNCTION = (TRANSFER-FILE)
 LAST-MODIF  = 2016-03-22 16:06:55

  4. You are the FT administrator and wish to view the profile acctrap1 on the ADM trap server.

    ftshwp acctrap1 -l

    Output takes the following form:

    acctrap1
 USER-ADM    = (ADMIN002,,OWN)
 FT-FUNCTION = (ADM-TRAP-LOG)
 LAST-MODIF  = 2016-01-23 18:24:42

    The value ADM-TRAP-LOG under FT-FUNCTION in the acctrap1 profile means that the remote administration server can receive ADM traps with this profile.

  5. You are the ADM administrator and wish to view the ADM profiles on the remote administration server.

    ftshwp -s=@a,@adm -l

    Output takes the following form:

    acccentr
 USER-ADM    = (*ADM,,OWN)
 FT-FUNCTION = (ACCESS-TO-ADMINISTRATION)
 LAST-MODIF  = 2016-01-23 18:21:08

    The profile acccentr is a ADM profile. This is indicated by the value ACCESS-TO-ADMINISTRATION under FT-FUNCTION and the value *ADM for user ID under USER-ADM.

  6. You are the FT administrator and would like to view the profile

    remadmin that has been set up for remote administration.

    ftshwp remadmin -l

    Output takes the following form:

    remadmin
 USER-ADM    = (ADMIN001,,OWN)
 FT-FUNCTION = (REMOTE-ADMINISTRATION)
 LAST-MODIF  = 2016-02-27 16:20:38
Powered by Atlassian Confluence and Scroll Viewport.