AuditNotificationCommands command group for the AdminTask object

You can use the Jython scripting language to manage the security auditing system with the wsadmin tool. Use the commands and parameters in the AuditNotificationCommands group to configure and manage audit notifications and audit notification monitors.

Note: 이 주제는 하나 이상의 애플리케이션 서버 로그 파일을 참조합니다. 권장되는 대안은 분배 및 IBM® i 시스템에서 SystemOut.log, SystemErr.log, trace.logactivity.log 파일을 사용하는 대신 HPEL(High Performance Extensible Logging) 로그를 사용하고 인프라를 추적하도록 서버를 구성하는 것입니다. 원시 z/OS® 로깅 기능과 연계하여 HPEL을 사용할 수도 있습니다. HPEL을 사용하는 경우 서버 프로파일 바이너리 디렉토리의 LogViewer 명령행 도구를 사용하여 모든 로그에 액세스하고 정보를 추적할 수 있습니다. HPEL 사용에 대한 자세한 정보는 HPEL을 사용한 애플리케이션 문제점 해결 정보를 참조하십시오.

createAuditNotification

The createAuditNotification command creates an audit notification object in the audit.xml configuration file.

이 명령을 실행하려면 사용자가 감사자 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Required parameters

-notificationName
Specifies the unique name to assign the audit notification object. (String, required)
-logToSystemOut
Specifies whether the system logs notifications to the SystemOut.log file.(Boolean, required)
-sendEmail
Specifies whether to email security auditing subsystem failure notifications. (Boolean, required)

Optional parameters

-emailList
Specifies the email list to send security auditing subsystem failure notifications. (String, optional)
-emailFormat
Specifies the email format. Specify HTML for HTML format or TEXT for text format. (String, optional)

Return value

The command returns the shortened reference ID of the new audit notification object, as the following sample output displays:
WSNotification_1184690835390

Batch mode example usage

  • Using Jython string:
    AdminTask.createAuditNotification('[-notificationName mynotification -logToSystemOut 
    true -sendEmail true -emailList admin@mycompany.com(smtp-server.mycompany.com) 
    -emailFormat HTML]')
  • Using Jython list:
    AdminTask.createAuditNotification(['-notificationName', 'mynotification', '-logToSystemOut', 
    'true', '-sendEmail', 'true', '-emailList', 'admin@mycompany.com(smtp-server.mycompany.com)', 
    '-emailFormat', 'HTML'])

Interactive mode example usage

  • Using Jython:
    AdminTask.createAuditNotification('-interactive')

createAuditNotificationMonitor

The createAuditNotificationMonitor command creates an audit notification monitor object for the security auditing system. This object monitors the security auditing subsystem for possible failure.

이 명령을 실행하려면 사용자가 감사자 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Required parameters

-monitorName
Specifies the unique name of the audit notification monitoring object. (String, required)
-notificationRef
Specifies the reference ID of the audit notification object. (String, required)
-enable
Specifies whether to enable the audit notification monitor. (Boolean, required)

Return value

The command returns the shortened form of the reference ID for the audit notification monitor, as the following sample output displays:
AuditNotificationMonitor_1184695615171

Batch mode example usage

  • Using Jython string:
    AdminTask.createAuditNotificationMonitor('-monitorName mymonitor -notificationRef 
    WSNotification_1184690835390 -enable true')
  • Using Jython list:
    AdminTask.createAuditNotificationMonitor(['-monitorName', 'mymonitor', '-notificationRef', 
    'WSNotification_1184690835390', '-enable', 'true'])

Interactive mode example usage

  • Using Jython:
    AdminTask.createAuditNotificationMonitor('-interactive')

deleteAuditNotification

The deleteAuditNotification command deletes an audit notification object from the audit.xml configuration file.

이 명령을 실행하려면 사용자가 감사자 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Required parameters

-notificationRef
Specifies the reference ID of the audit notification object to delete. (String, required)

Return value

The command returns a value of true if the system successfully deletes the audit notification object from the audit.xml configuration file.

Batch mode example usage

  • Using Jython string:
    AdminTask.deleteAuditNotification('-notificationRef WSNotification_1184690835390')
  • Using Jython list:
    AdminTask.deleteAuditNotification(['-notificationRef', 'WSNotification_1184690835390'])

Interactive mode example usage

  • Using Jython:
    AdminTask.deleteAuditNotification('-interactive')

deleteAuditNotificationMonitorByName

The deleteAuditNotificationMonitorByName command deletes the audit notification monitor that the user specifies with the unique name.

이 명령을 실행하려면 사용자가 감사자 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Required parameters

-monitorName
Specifies the unique name of the audit notification monitor to delete. (String, required)

Return value

The command returns a value of true if the system successfully deletes the audit notification monitor from the configuration.

Batch mode example usage

  • Using Jython string:
    AdminTask.deleteAuditNotificationMonitor('-monitorName mymonitor')
  • Using Jython list:
    AdminTask.deleteAuditNotificationMonitor(['-monitorName', 'mymonitor'])

Interactive mode example usage

  • Using Jython:
    AdminTask.deleteAuditNotificationMonitor('-interactive')

deleteAuditNotificationMonitorByRef

The deleteAuditNotificationMonitorByRef command deletes the audit notification monitor that the user specifies with the reference ID.

이 명령을 실행하려면 사용자가 감사자 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Required parameters

-monitorRef
Specifies the reference ID of the audit notification monitor object to delete. (String, required)

Return value

The command returns a value of true if the system successfully deletes the audit notification monitor of interest.

Batch mode example usage

  • Using Jython string:
    AdminTask.deleteAuditNotificationMonitor('-monitorRef 
    AuditNotificationMonitor_1184695615171')
  • Using Jython list:
    AdminTask.deleteAuditNotificationMonitor(['-monitorRef', 
    'AuditNotificationMonitor_1184695615171'])

Interactive mode example usage

  • Using Jython:
    AdminTask.deleteAuditNotificationMonitor('-interactive')

getAuditNotification

The getAuditNotification command retrieves the attributes for an audit notification object of interest.

이 명령을 실행하려면 사용자가 모니터 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Required parameters

-notificationRef
Specifies the reference ID of the audit notification object of interest. (String, required)

Return value

The command returns a list of attributes for the specific audit notification object, as the following sample output displays:
{{name mynotification}
{sslConfig {}}
{logToSystemOut true}
{_Websphere_Config_Data_Id cells/CHEYENNENode04Cell|audit.xml#WSNotification_1184690835390}
{emailList sweetshadow@us.ibm.com(smtp-server.us.ibm.com)}
{sendEmail true}
{_Websphere_Config_Data_Type WSNotification}
{properties {}}
{emailFormat HTML}}

Batch mode example usage

  • Using Jython string:
    AdminTask.getAuditNotification('-notificationRef WSNotification_1184690835390')
  • Using Jython list:
    AdminTask.getAuditNotification(['-notificationRef', 'WSNotification_1184690835390'])

Interactive mode example usage

  • Using Jython:
    AdminTask.getAuditNotification('-interactive')

getAuditNotificationMonitor

The getAuditNotificationMonitor command retrieves the attributes that the system associates with the audit notification monitor of interest.

이 명령을 실행하려면 사용자가 모니터 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Required parameters

-monitorRef
Specifies the reference ID of the audit notification monitor of interest. (String, required)

Return value

The command returns a list of attributes for the audit notification monitor of interest, as the following sample output displays:
{{name mymonitor}
{enabled true}
{_Websphere_Config_Data_Id cells/Node04Cell|audit.xml#AuditNotificationMonitor_1184695615171}
{_Websphere_Config_Data_Type AuditNotificationMonitor}
{wsNotification mynotification(cells/Node04Cell|audit.xml#WSNotification_1184690835390)}}

Batch mode example usage

  • Using Jython string:
    AdminTask.getAuditNotificationMonitor('-monitorRef 
    AuditNotificationMonitor_1184695615171')
  • Using Jython list:
    AdminTask.getAuditNotificationMonitor(['-monitorRef', 
    'AuditNotificationMonitor_1184695615171'])

Interactive mode example usage

  • Using Jython:
    AdminTask.getAuditNotificationMonitor('-interactive')

getEmailList

The getEmailList command retrieves the email distribution list for the audit notification object. If the notification monitor is not configured, the audit notification object is not active and the command returns a null value.

이 명령을 실행하려면 사용자가 모니터 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Return value

The command returns this email list for the active audit notification object, as the following sample output displays:
admin@mycompany.com(smtp-server.mycompany.com)

Batch mode example usage

  • Using Jython string:
    AdminTask.getEmailList()
  • Using Jython list:
    AdminTask.getEmailList()

Interactive mode example usage

  • Using Jython:
    AdminTask.getEmailList('-interactive')

getSendEmail

The getSendEmail command displays whether or not the audit notification object sends an email if the audit subsystem fails. If the notification monitor is not configured, the audit notification object is not active and the command returns a null value.

이 명령을 실행하려면 사용자가 모니터 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Return value

The command returns a value of true if the system is configured to send an email to the distribution list.

Batch mode example usage

  • Using Jython string:
    AdminTask.getSendEmail()
  • Using Jython list:
    AdminTask.getSendEmail()

Interactive mode example usage

  • Using Jython:
    AdminTask.getSendEmail('-interactive')

getAuditNotificationRef

The getAuditNotificationRef command retrieves the reference ID for the active audit notification object. If the notification monitor is not configured, the audit notification object is not active and the command returns a null value.

이 명령을 실행하려면 사용자가 모니터 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Return value

The command returns the reference ID of the audit notification object if it is active, as the following sample output displays:
WSNotification_1184690835390

Batch mode example usage

  • Using Jython string:
    AdminTask.getAuditNotificationRef()
  • Using Jython list:
    AdminTask.getAuditNotificationRef()

Interactive mode example usage

  • Using Jython:
    AdminTask.getAuditNotificationRef('-interactive')

getAuditNotificationName

The getAuditNotificationName command retrieves the unique name for the active audit notification object. If the notification monitor is not configured, the audit notification object is not active and the command returns a null value.

이 명령을 실행하려면 사용자가 모니터 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Return value

The command returns the unique name of the audit notification object, as the following sample output displays:
mynotification

Batch mode example usage

  • Using Jython string:
    AdminTask.getAuditNotificationName()
  • Using Jython list:
    AdminTask.getAuditNotificationName()

Interactive mode example usage

  • Using Jython:
    AdminTask.getAuditNotificationName('-interactive')

isSendEmailEnabled

The isSendEmailEnabled command determines if the system is configured to send an email if the security auditing subsystem fails.

이 명령을 실행하려면 사용자가 모니터 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Return value

The command returns a value of true if email notification is enabled.

Batch mode example usage

  • Using Jython string:
    AdminTask.isSendEmailEnabled()
  • Using Jython list:
    AdminTask.isSendEmailEnabled()

Interactive mode example usage

  • Using Jython:
    AdminTask.isSendEmailEnabled('-interactive')

isAuditNotificationEnabled

The isAuditNotificationEnabled command determines whether the security auditing system notifications are enabled.

이 명령을 실행하려면 사용자가 모니터 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Return value

The command returns a value of true if security auditing system notifications are enabled.

Batch mode example usage

  • Using Jython string:
    AdminTask.isAuditNotificationEnabled()
  • Using Jython list:
    AdminTask.isAuditNotificationEnabled()

Interactive mode example usage

  • Using Jython:
    AdminTask.isAuditNotificationEnabled()

listAuditNotifications

The listAuditNotifications command retrieves the attributes for each audit notification object that is configured in the audit.xml file.

이 명령을 실행하려면 사용자가 모니터 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Return value

The command returns a list of attributes for each configured audit notification object, as the following sample output displays:
{{name mynotification}
{sslConfig {}}
{logToSystemOut true}
{_Websphere_Config_Data_Id cells/CHEYENNENode04Cell|audit.xml#WSNotification_1184690835390}
{emailList sweetshadow@us.ibm.com(smtp-server.us.ibm.com)}
{sendEmail true}
{notificationRef WSNotification_1184690835390}
{_Websphere_Config_Data_Type WSNotification}
{properties {}}
{emailFormat HTML}}

Batch mode example usage

  • Using Jython string:
    AdminTask.listAuditNotifications()
  • Using Jython list:
    AdminTask.listAuditNotifications()

Interactive mode example usage

  • Using Jython:
    AdminTask.listAuditNotifications('-interactive')

listAuditNotificationMonitors

The listAuditNotificationMonitors command lists the attributes for the audit notification monitor that is configured in the audit.xml file.

이 명령을 실행하려면 사용자가 모니터 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Return value

The command returns a list of attributes for the audit notification monitor, as the following sample output displays:
{{name mymonitor}
{enabled true}
{_Websphere_Config_Data_Id cells/Node04Cell|audit.xml#AuditNotificationMonitor_1184695615171}
{_Websphere_Config_Data_Type AuditNotificationMonitor}
{monitorRef AuditNotificationMonitor_1184695615171}
{wsNotification mynotification(cells/Node04Cell|audit.xml#WSNotification_1184690835390)}
{notificationRef WSNotification_1184690835390}}

Batch mode example usage

  • Using Jython string:
    AdminTask.listAuditNotificationMonitors()
  • Using Jython list:
    AdminTask.listAuditNotificationMonitors()

Interactive mode example usage

  • Using Jython:
    AdminTask.listAuditNotificationMonitors('-interactive'b)

modifyAuditNotification

The modifyAuditNotification command edits the audit notification object in the audit.xml configuration file.

이 명령을 실행하려면 사용자가 감사자 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Required parameters

-notificationRef
Specifies the reference ID of the audit notification object to edit. (String, required)

Optional parameters

-logToSystemOut
Specifies whether to log notifications to the SystemOut.log file. (Boolean, optional)
-sendEmail
Specifies whether to email notifications. (Boolean, optional)
-emailList
Specifies the email address of distribution list where the system sends email notifications. (String, optional)
-emailFormat
Specifies the email format. Specify HTML for HTML format or TEXT for text format. (String, optional)

Return value

The command returns a value of true if the system successfully updates the security auditing system configuration.

Batch mode example usage

  • Using Jython string:
    AdminTask.modifyAuditNotification('-notificationRef WSNotification_1184690835390 
    -logToSystemOut false -sendEmail true -emailList admin@mycompany.com(smtp-server.mycompany.com) 
    -emailFormat TEXT')
  • Using Jython list:
    AdminTask.modifyAuditNotification(['-notificationRef', 'WSNotification_1184690835390', 
    '-logToSystemOut', 'false', '-sendEmail', 'true', '-emailList', 
    'admin@mycompany.com(smtp-server.mycompany.com)', '-emailFormat', 'TEXT'])

Interactive mode example usage

  • Using Jython:
    AdminTask.modifyAuditNotification('-interactive')

modifyAuditNotificationMonitor

The modifyAuditNotificationMonitor command edits the audit notification monitor configuration for the security auditing system.

이 명령을 실행하려면 사용자가 감사자 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Required parameters

-monitorRef
Specifies the reference ID of the audit notification monitor of interest. (String, required)

Optional parameters

-notificationRef
Specifies the reference ID of the audit notification object. (String, optional)
-enable
Specifies whether to enable the audit notification monitor. (Boolean, optional)

Return value

The command returns a value of true if the system successfully updates the audit notification monitor configuration.

Batch mode example usage

  • Using Jython string:
    AdminTask.modifyAuditNotificationMonitor('-monitorRef AuditNotificationMonitor_1184695615171 
    -notificationRef WSNotification_1184690835390 -enable true')
  • Using Jython list:
    AdminTask.modifyAuditNotificationMonitor(['-monitorRef', 'AuditNotificationMonitor_1184695615171', 
    '-notificationRef', 'WSNotification_1184690835390', '-enable', 'true'])

Interactive mode example usage

  • Using Jython:
    AdminTask.modifyAuditNotificationMonitor('-interactive')

setEmailList

The setEmailList command specifies the distribution list to send email notifications to if the security auditing subsystem fails.

이 명령을 실행하려면 사용자가 감사자 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Required parameters

-emailList
Specifies the email address or email distribution list to send audit notifications to. (String, required)

Return value

The command returns a value of true if the system successfully sets the email notification list for the notification object.

Batch mode example usage

  • Using Jython string:
    AdminTask.setEmailList('[-emailList admin@mycompany.com(smtp-server.mycompany.com)]')
  • Using Jython list:
    AdminTask.setEmailList(['-emailList', 'admin@mycompany.com(smtp-server.mycompany.com)'])

Interactive mode example usage

  • Using Jython string:
    AdminTask.setEmailList('-interactive')

setSendEmail

The setSendEmail command enables or disables email notifications for the security auditing system.

이 명령을 실행하려면 사용자가 감사자 관리 역할을 보유하고 있어야 합니다.

Target object

None.

Required parameters

-enable
Specifies whether to enable the system to send audit notifications by email. (Boolean, required)

Return value

The command returns a value of true if the system successfully modifies the configuration.

Batch mode example usage

  • Using Jython string:
    AdminTask.setSendEmail('-enable true')
  • Using Jython list:
    AdminTask.setSendEmail(['-enable', 'true'])

Interactive mode example usage

  • Using Jython:
    AdminTask.setSendEmail('-interactive')

주제 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: July 9, 2016 6:09
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7audit7
파일 이름:rxml_7audit7.html