PMDF popstore & MessageStore Manager's Guide
PMDF-POP-6.0

Previous | Contents

5.2.1.4 show_user command: show information about the user's account

The show_user command is used to display information about a given user. The parameter names and associated values accepted by the command are listed in Table 5-4 .

This command must be presented to the user information CGI via the URL 

http://host:7633/popstore_user/

Table 5-4 show_usercommand parameters
parameter=value Description
mformat=file-spec Optional Name of the formatting file to use to format each message reference in the account's list of stored messages. The recognized substitution strings for this formatting file are listed in Tables 4-10 and 4-24 .
on_error=file-spec Required Name of the formatting file to use to format the results when the command fails.
on_success=file-spec Required Name of the formatting file to use to format the results when the command succeeds.
pformat=file-spec Required Name of the formatting file to use to format each account listing. The recognized substitution strings for this formatting file are listed in Table 4-10 and 4-15 .

An example command is shown below: 

command=show_user&pformat=susr.txt&mformat=smsg.txt 
  on_success=susr_success.txt&on_error=susr_error.txt
Sample formatting files are shown in Example 5-2 and Example 5-3 . These are the formatting files used by the interactive command line management utility.

Example 5-2 show_useraccount formattingfile 

 
Username:           %username 
Owner:              %owner 
Group:              %group_name 
Usage flags:        %flags 
 
Last connect:       %last_connect 
Last disconnect:    %last_disconnect 
Total connect time: %total_connect_dhms 
Total connections:  %total_connections 
Past block days:    %past_block_days 
Last billing:       %last_billing 
 
Message count:      %message_count{%10u} 
Quota used:         %quota_used_k{%10.2f} Kbyte%s 
Primary quota:      %quota_k{%10.2f} Kbyte%s 
Overdraft quota:    %overdraft_k{%10.2f} Kbyte%s

Example 5-3 show_usermessage list formattingfile 

%none{User has no stored messages} 
%msgr_id{%4u}. Filename: %msgr_filename 
      Received: %msgr_created 
      Size:     %msgr_size_k K 
      Flags:    %msgr_flags

5.2.2 Header trimming of displayed messages

Header trimming is applied to the displayed message's header when the part parameter is supplied to the show command. The user CGI uses a default header trimming option file, popstore_cgi_headers.opt, file located in the PMDF table directory. To use different options, create a new header trimming option file named popstore_site_cgi_headers.opt. Place that file in the PMDF_table directory. (On UNIX systems, ensure that the file is owned by the PMDF account.) When that file is detected, it will be used instead of the Innosoft-supplied file. The Innosoft-supplied file will be ignored and only those options specified in the site-supplied file used.

See the PMDF System Manager's Guide for information on the use and format of header trimming option files.

Previous | Next | Contents